=head1 NAME

UNIVERSAL - base class for ALL classes (blessed references)
J<< ja; UNIVERSAL - 全てのクラス(ブレスされたリファレンス)の基底クラス >>

=head1 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 ;

=head1 DESCRIPTION

C<UNIVERSAL> is the base class which all bless references will inherit from,
see L<perlobj>.
J<< ja;
C<UNIVERSAL> は全てのブレスされたリファレンスが継承する基底クラスです, 
L<perlobj> も参照してください. 
>>

C<UNIVERSAL> provides the following methods and functions:
J<< ja;
C<UNIVERSAL> は以下のメソッドと関数を提供しています:
>>

=over 4

=item C<< $obj->isa( TYPE ) >>

=item C<< CLASS->isa( TYPE ) >> 

=item C<isa( VAL, TYPE )>

Where
J<< ja;
ここで
>>

=over 4

=item C<TYPE>

is a package name
J<< ja;
はパッケージ名
>>

=item C<$obj>

is a blessed reference or a string containing a package name
J<< ja;
はブレスされたリファレンスかパッケージ名を含んだ文字列
>>

=item C<CLASS>

is a package name
J<< ja;
はパッケージ名
>>

=item C<VAL>

is any of the above or an unblessed reference
J<< ja;
上のいずれかかブレスされていないリファレンス
>>

=back

When used as an instance or class method (C<< $obj->isa( TYPE ) >>),
C<isa> returns I<true> if $obj is blessed into package C<TYPE> or
inherits from package C<TYPE>.
J<<<< ja;
インスタンス若しくはクラスメソッド (C<< $obj->isa( TYPE ) >>)として
使うときは $obj がパッケージ C<TYPE> 若しくはパッケージ C<TYPE> 
の派生にブレスされているときに I<真> を返します. 
>>>>

When used as a class method (C<< CLASS->isa( TYPE ) >>: sometimes
referred to as a static method), C<isa> returns I<true> if C<CLASS>
inherits from (or is itself) the name of the package C<TYPE> or
inherits from package C<TYPE>.
J<<<< ja;
クラスメソッド  (C<< CLASS->isa( TYPE ) >>: スタティックメソッドとして
参照されることもあります)として使う時は C<CLASS> がパッケージ名 
C<TYPE> 若しくはパッケージ C<TYPE> の派生から派生している(若しくは
そのもの)の時に I<真> を返します. 
>>>>

When used as a function, like
J<< ja;
関数として使うとき, 例えば
>>

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

or
J<< ja;
若しくは
>>

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

C<isa> returns I<true> in the same cases as above and also if C<VAL> is an
unblessed reference to a perl variable of type C<TYPE>, such as "HASH",
"ARRAY", or "Regexp".
J<< ja;
上のいずれかと同じケースでと C<VAL> が "HASH", "ARRAY", 若しくは 
"Regexp" といった C<type> 型の perl 変数へのブレスされていない
リファレンスの時に I<真> を返します. 
>>

=item C<< $obj->can( METHOD ) >>

=item C<< CLASS->can( METHOD ) >>

=item C<can( VAL, METHOD )>

C<can> checks if the object or class has a method called C<METHOD>. If it does
then a reference to the sub is returned. If it does not then I<undef> is
returned.  This includes methods inherited or imported by C<$obj>, C<CLASS>, or
C<VAL>.
J<< ja;
C<can> はオブジェクト若しくはクラスが C<METHOD> というメソッドを
持っているかを調べます. もし持っていれば関数リファレンスが返されます. 
もし持っていなければ I<undef> が返されます. これには C<$obj>, 
C<CLASS>, 若しくは C<VAL> で継承されている若しくはインポートされている
メソッドが含まれます. 
>>

C<can> cannot know whether an object will be able to provide a method
through AUTOLOAD, so a return value of I<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 L<perlsub>)
for methods they will handle via AUTOLOAD. For such 'dummy' subs, C<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.
J<< ja;
C<can> はオブジェクトが AUTOLOAD を通してメソッドを提供可能かどうかは
知ることができません, そのため I<undef> が返ってきてもオブジェクトが
そのメソッド呼び出しを処理することができないとは限りません. これを
回避するにはモジュールの作者が AUTOLOAD を使って処理するメソッドに対して
前方宣言を使うことです(L<perlsub>参照). そのような'ダミー'の関数は
C<can> はコードリファレンスを返しますが, それが呼び出された時には
AUTOLOAD へとフォールスルーされます. もし適切な AUTOLOAD が提供されて
いなければ, コードリファレンスの呼び出しはエラーになるでしょう. 
>>

C<can> can be called as a class (static) method, an object method, or a
function.
J<< ja;
C<can> はクラス(スタティック)メソッド, オブジェクトメソッド, 
さらには関数として呼び出すこともできます.
>>

When used as a function, if C<VAL> is a blessed reference or package name which
has a method called C<METHOD>, C<can> returns a reference to the subroutine.
If C<VAL> is not a blessed reference, or if it does not have a method
C<METHOD>, I<undef> is returned.
J<< ja;
関数として呼び出されたときには, C<VAL> は C<METHOD> というメソッドを
持っているブレスされたリファレンスかパッケージ名の時に C<can> は
関数へのリファレンスを返します. C<VAL> がブレスされたリファレンスで
なかったり, C<METHOD> というメソッドを持っていなかったときには
I<undef> が返されます. 
>>

=item C<VERSION ( [ REQUIRE ] )>

C<VERSION> will return the value of the variable C<$VERSION> in the
package the object is blessed into. If C<REQUIRE> is given then
it will do a comparison and die if the package version is not
greater than or equal to C<REQUIRE>.
J<< ja;
C<VERISON> はオブジェクトがブレスされているパッケージの変数 
C<$VERSION> の値を返します. もし C<REQUIRE> が与えられていた
場合には比較をおコアってパッケージのバージョンが C<REQUIRE>
以上でなかった場合には die します. 
>>

C<VERSION> can be called as either a class (static) method, an object
method or a function.
J<< ja;
C<VERSION> はクラス(スタティック)メソッド, オブジェクトメソッド, 
さらには関数として呼び出すこともできます.
>>


=back

=head1 EXPORTS

None by default.
J<< ja;
デフォルトでは何もエクスポートされません. 
>>

You may request the import of all three functions (C<isa>, C<can>, and
C<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
C<isa>, which is useful as a function when operating on non-blessed
references.
J<< ja;
もし３つの関数全て (C<isa>, C<can>, 及び C<VERISON>)を
インポートさせたいかもしれませんが, 通常はその必要はありません. 
Perl は魔法のようにこれらの関数を全てのオブジェクトでメソッドとして
動作させます. １つ例外は C<isa> で, これはブレスされていない
リファレンスに対して操作するときに関数として役に立ちます. 
>>


=head1 TRANSALTE TO JAPANESE
J<< ja;和訳 >>

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

Origlnal distribution is perl VERSION 5.8.8.
Translated at 2007-03-18.
J<< ja;
原典: perl VERSION 5.8.8.
翻訳日: 2007-03-18.
>>

=cut