NAME 名前

UNIVERSAL - base class for ALL classes (blessed references)

UNIVERSAL - 全てのクラス(ブレスされたリファレンス)の基底クラス

SYNOPSIS 概要

    $is_io = $fd->isa("IO::Handle");
    $is_io = Class->isa("IO::Handle");

    $sub = $obj->can("print");
    $sub = Class->can("print");

    use UNIVERSAL qw( isa can VERSION );
    $yes = isa $ref, "HASH" ;
    $sub = can $ref, "fandango" ;
    $ver = VERSION $obj ;

DESCRIPTION 説明

UNIVERSAL is the base class which all bless references will inherit from, see perlobj [CPAN].

UNIVERSAL は全てのブレスされたリファレンスが継承する基底クラスです, perlobj [CPAN] も参照してください.

UNIVERSAL provides the following methods and functions:

UNIVERSAL は以下のメソッドと関数を提供しています:

$obj->isa( TYPE )

CLASS->isa( TYPE )

isa( VAL, TYPE )

Where

ここで

TYPE

is a package name

はパッケージ名

$obj

is a blessed reference or a string containing a package name

はブレスされたリファレンスかパッケージ名を含んだ文字列

CLASS

is a package name

はパッケージ名

VAL

is any of the above or an unblessed reference

上のいずれかかブレスされていないリファレンス

When used as an instance or class method ($obj->isa( TYPE )), isa returns true if $obj is blessed into package TYPE or inherits from package TYPE.

インスタンス若しくはクラスメソッド ($obj->isa( TYPE ))として 使うときは $obj がパッケージ TYPE 若しくはパッケージ TYPE の派生にブレスされているときに 真 を返します.

When used as a class method (CLASS->isa( TYPE ): sometimes referred to as a static method), isa returns true if CLASS inherits from (or is itself) the name of the package TYPE or inherits from package TYPE.

クラスメソッド (CLASS->isa( TYPE ): スタティックメソッドとして 参照されることもあります)として使う時は CLASS がパッケージ名 TYPE 若しくはパッケージ TYPE の派生から派生している(若しくは そのもの)の時に 真 を返します.

When used as a function, like

関数として使うとき, 例えば

   use UNIVERSAL qw( isa ) ;
   $yes = isa $h, "HASH";
   $yes = isa "Foo", "Bar";

or

若しくは

   require UNIVERSAL ;
   $yes = UNIVERSAL::isa $a, "ARRAY";

isa returns true in the same cases as above and also if VAL is an unblessed reference to a perl variable of type TYPE, such as "HASH", "ARRAY", or "Regexp".

上のいずれかと同じケースでと VAL が "HASH", "ARRAY", 若しくは "Regexp" といった type 型の perl 変数へのブレスされていない リファレンスの時に 真 を返します.

$obj->can( METHOD )

CLASS->can( METHOD )

can( VAL, METHOD )

can checks if the object or class has a method called METHOD. If it does then a reference to the sub is returned. If it does not then undef is returned. This includes methods inherited or imported by $obj, CLASS, or VAL.

can はオブジェクト若しくはクラスが METHOD というメソッドを 持っているかを調べます. もし持っていれば関数リファレンスが返されます. もし持っていなければ undef が返されます. これには $obj, CLASS, 若しくは VAL で継承されている若しくはインポートされている メソッドが含まれます.

can cannot know whether an object will be able to provide a method through AUTOLOAD, so a return value of undef does not necessarily mean the object will not be able to handle the method call. To get around this some module authors use a forward declaration (see perlsub [CPAN]) for methods they will handle via AUTOLOAD. For such 'dummy' subs, can will still return a code reference, which, when called, will fall through to the AUTOLOAD. If no suitable AUTOLOAD is provided, calling the coderef will cause an error.

can はオブジェクトが AUTOLOAD を通してメソッドを提供可能かどうかは 知ることができません, そのため undef が返ってきてもオブジェクトが そのメソッド呼び出しを処理することができないとは限りません. これを 回避するにはモジュールの作者が AUTOLOAD を使って処理するメソッドに対して 前方宣言を使うことです(perlsub [CPAN]参照). そのような'ダミー'の関数は can はコードリファレンスを返しますが, それが呼び出された時には AUTOLOAD へとフォールスルーされます. もし適切な AUTOLOAD が提供されて いなければ, コードリファレンスの呼び出しはエラーになるでしょう.

can can be called as a class (static) method, an object method, or a function.

can はクラス(スタティック)メソッド, オブジェクトメソッド, さらには関数として呼び出すこともできます.

When used as a function, if VAL is a blessed reference or package name which has a method called METHOD, can returns a reference to the subroutine. If VAL is not a blessed reference, or if it does not have a method METHOD, undef is returned.

関数として呼び出されたときには, VAL は METHOD というメソッドを 持っているブレスされたリファレンスかパッケージ名の時に can は 関数へのリファレンスを返します. VAL がブレスされたリファレンスで なかったり, METHOD というメソッドを持っていなかったときには undef が返されます.

VERSION ( [ REQUIRE ] )

VERSION will return the value of the variable $VERSION in the package the object is blessed into. If REQUIRE is given then it will do a comparison and die if the package version is not greater than or equal to REQUIRE.

VERISON はオブジェクトがブレスされているパッケージの変数 $VERSION の値を返します. もし REQUIRE が与えられていた 場合には比較をおコアってパッケージのバージョンが REQUIRE 以上でなかった場合には die します.

VERSION can be called as either a class (static) method, an object method or a function.

VERSION はクラス(スタティック)メソッド, オブジェクトメソッド, さらには関数として呼び出すこともできます.

EXPORTS エクスポート

None by default.

デフォルトでは何もエクスポートされません.

You may request the import of all three functions (isa, can, and VERSION), however it isn't usually necessary to do so. Perl magically makes these functions act as methods on all objects. The one exception is isa, which is useful as a function when operating on non-blessed references.

もし３つの関数全て (isa, can, 及び VERISON)を インポートさせたいかもしれませんが, 通常はその必要はありません. Perl は魔法のようにこれらの関数を全てのオブジェクトでメソッドとして 動作させます. １つ例外は isa で, これはブレスされていない リファレンスに対して操作するときに関数として役に立ちます.

TRANSALTE TO JAPANESE 和訳

 山科 氷魚 (YAMASHINA Hio) <hio@hio.jp>

Origlnal distribution is perl VERSION 5.8.8. Translated at 2007-03-18.

原典: perl VERSION 5.8.8. 翻訳日: 2007-03-18.

索引