perl-5.20.1
use Module VERSION LIST
use Module VERSION
use Module LIST
use Module
use VERSION

Imports some semantics into the current package from the named module, generally by aliasing certain subroutine or variable names into your package. It is exactly equivalent to

指定したモジュールから、現在のパッケージにさまざまな内容をインポートします; 多くは、パッケージのサブルーチン名や、変数名に別名を付けることで、 実現されています。 これは、以下は等価ですが:

    BEGIN { require Module; Module->import( LIST ); }

except that Module must be a bareword. The importation can be made conditional by using the if module.

Module が 裸の単語でなければならない ことを除けば、です。 インポートは、if を使って条件付きで行うことができます。

In the peculiar use VERSION form, VERSION may be either a positive decimal fraction such as 5.006, which will be compared to $], or a v-string of the form v5.6.1, which will be compared to $^V (aka $PERL_VERSION). An exception is raised if VERSION is greater than the version of the current Perl interpreter; Perl will not attempt to parse the rest of the file. Compare with require, which can do a similar check at run time. Symmetrically, no VERSION allows you to specify that you want a version of Perl older than the specified one.

特に use VERSION の形式では、 VERSION は 5.006 のような正の 10 進小数 ($] と比較されます)か、v5.6.1 の形 ($^V (またの名を $PERL_VERSION) と比較されます) のv-文字列で指定します。 VERSION が Perl の現在のバージョンより大きいと、例外が発生します; Perl はファイルの残りを読み込みません。 require と似ていますが、これは実行時にチェックされます。 対称的に、no VERSION は指定されたバージョンより古いバージョンの Perl で 動作させたいことを意味します。

Specifying VERSION as a literal of the form v5.6.1 should generally be avoided, because it leads to misleading error messages under earlier versions of Perl (that is, prior to 5.6.0) that do not support this syntax. The equivalent numeric version should be used instead.

VERSION に v5.6.1 の形のリテラルを指定することは一般的には避けるべきです; なぜなら、この文法に対応していない Perl の初期のバージョン (つまり、 5.6.0 以前) では誤解させるようなエラーメッセージが出るからです。 代わりに等価な数値表現を使うべきです。

    use v5.6.1;     # compile time version check
    use 5.6.1;      # ditto
    use 5.006_001;  # ditto; preferred for backwards compatibility

This is often useful if you need to check the current Perl version before useing library modules that won't work with older versions of Perl. (We try not to do this more than we have to.)

これは古いバージョンの Perl で動かなくなったライブラリモジュールを use する前に、現在の Perl のバージョンを調べたい場合に有用です。 (我々は必要な場合以外にそのようなことがないように努力していますが。)

use VERSION also enables all features available in the requested version as defined by the feature pragma, disabling any features not in the requested version's feature bundle. See feature. Similarly, if the specified Perl version is greater than or equal to 5.12.0, strictures are enabled lexically as with use strict. Any explicit use of use strict or no strict overrides use VERSION, even if it comes before it. In both cases, the feature.pm and strict.pm files are not actually loaded.

use VERSION は、feature プラグマで定義されたように、指定された バージョンで利用可能な全ての機能を有効にし、指定されたバージョンの機能の 束にない機能を無効にします。 feature を参照してください。 同様に、指定された Perl のバージョンが 5.12.0 以上の場合、 制限は use strict と同様にレキシカルに有効になります。 明示的に use strictno strict を使うと、例え先に 指定されていたとしても、use VERSION を上書きします。 どちらの場合も、feature.pmstrict.pm ファイルは実際には 読み込まれません。

The BEGIN forces the require and import to happen at compile time. The require makes sure the module is loaded into memory if it hasn't been yet. The import is not a builtin; it's just an ordinary static method call into the Module package to tell the module to import the list of features back into the current package. The module can implement its import method any way it likes, though most modules just choose to derive their import method via inheritance from the Exporter class that is defined in the Exporter module. See Exporter. If no import method can be found then the call is skipped, even if there is an AUTOLOAD method.

BEGIN によって、requireimport は、コンパイル時に 実行されることになります。 require は、モジュールがまだメモリにロードされていなければ、ロードします。 import は、組込みの関数ではありません; さまざまな機能を現在のパッケージに インポートするように Module パッケージに伝えるために呼ばれる、 通常の静的メソッドです。 モジュール側では、import メソッドをどのようにでも実装することが できますが、多くのモジュールでは、Exporter モジュールで定義された、 Exporter クラスからの継承によって、import メソッドを行なうように しています。 Exporterモジュールを参照してください。 importメソッドが見つからなかった場合、AUTOLOAD メソッドがあったとしても 呼び出しはスキップされます。

If you do not want to call the package's import method (for instance, to stop your namespace from being altered), explicitly supply the empty list:

パッケージの import メソッドを呼び出したくない場合(例えば、名前空間を 変更したくない場合など)は、明示的に空リストを指定してください:

    use Module ();

That is exactly equivalent to

これは以下と完全に等価です:

    BEGIN { require Module }

If the VERSION argument is present between Module and LIST, then the use will call the VERSION method in class Module with the given version as an argument. The default VERSION method, inherited from the UNIVERSAL class, croaks if the given version is larger than the value of the variable $Module::VERSION.

Module と LIST の間に VERSION 引数がある場合、use は Module クラスの VERSION メソッドを、与えられたバージョンを引数として呼び出します。 デフォルトの VERSION メソッドは、 UNIVERSAL クラスから継承したもので、 与えられたバージョンが 変数 $Module::VERSION の値より大きい場合に 警告を出します。

Again, there is a distinction between omitting LIST (import called with no arguments) and an explicit empty LIST () (import not called). Note that there is no comma after VERSION!

繰り返すと、LIST を省略する(import が引数なしで呼び出される)ことと 明示的に空の LIST () を指定する (import は呼び出されない)ことは 違います。 VERSION の後ろにカンマが不要なことに注意してください!

Because this is a wide-open interface, pragmas (compiler directives) are also implemented this way. Currently implemented pragmas are:

これは、広く公開されているインタフェースですので、 プラグマ (コンパイラディレクティブ) も、この方法で実装されています。 現在実装されているプラグマには、以下のものがあります:

    use constant;
    use diagnostics;
    use integer;
    use sigtrap  qw(SEGV BUS);
    use strict   qw(subs vars refs);
    use subs     qw(afunc blurfl);
    use warnings qw(all);
    use sort     qw(stable _quicksort _mergesort);

Some of these pseudo-modules import semantics into the current block scope (like strict or integer, unlike ordinary modules, which import symbols into the current package (which are effective through the end of the file).

通常のモジュールが、現在のパッケージにシンボルをインポートする (これは、ファイルの終わりまで有効です) のに対して、 これらの擬似モジュールの一部(strictinteger など)は、 現在のブロックスコープにインポートを行ないます。

Because use takes effect at compile time, it doesn't respect the ordinary flow control of the code being compiled. In particular, putting a use inside the false branch of a conditional doesn't prevent it from being processed. If a module or pragma only needs to be loaded conditionally, this can be done using the if pragma:

use はコンパイル時に有効なので、コードがコンパイルされる際の通常の 流れ制御には従いません。 特に、条件文のうち成立しない側の中に use を書いても、 処理を妨げられません。 モジュールやプラグマを条件付きでのみ読み込みたい場合、 if プラグマを使って実現できます:

    use if $] < 5.008, "utf8";
    use if WANT_WARNINGS, warnings => qw(all);

There's a corresponding no declaration that unimports meanings imported by use, i.e., it calls unimport Module LIST instead of import. It behaves just as import does with VERSION, an omitted or empty LIST, or no unimport method being found.

これに対して、no 宣言という、use によってインポートされたものを、 インポートされていないことにするものがあります; つまり、import の代わりに unimport Module LIST を呼び出します。 これは VERSION、省略された LIST、空の LIST、unimport メソッドが見つからない 場合などの観点では、import と同様に振る舞います。

    no integer;
    no strict 'refs';
    no warnings;

Care should be taken when using the no VERSION form of no. It is only meant to be used to assert that the running Perl is of a earlier version than its argument and not to undo the feature-enabling side effects of use VERSION.

nono VERSION 形式を使うときには注意を払うべきです。 これは引数で指定されたバージョンよりも前の Perl で実行されたときに アサートされることを意味する だけ で、use VERSION によって 有効にされた副作用をなかったことにするもの ではありません

See perlmodlib for a list of standard modules and pragmas. See perlrun for the -M and -m command-line options to Perl that give use functionality from the command-line.

標準モジュールやプラグマの一覧は、perlmodlib を参照してください。 コマンドラインから use 機能を指定するための -M-m の コマンドラインオプションについては perlrun を参照してください。