use
use Module list use version use Module version list
- If the first argument is a number, it is treated as a version number. If the version of Perl is less than version, an error message is printed and Perl exits. This provides a way to check the Perl version at compilation time, instead of waiting for runtime.
If version appears between Module and list, then
use
calls theversion
method in class Module with version as an argument.Otherwise,
use
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 the following:BEGIN { require Module; import Module list; }
TheBEGIN
forces therequire
andimport
to happen at compile time. Therequire
makes sure that the module is loaded into memory if it hasn't been yet. Theimport
is not a built-in function - it's just an ordinary static method call into the package named by Module 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.If you don't want your namespace altered, explicitly supply an empty list:
use Module ();
That is exactly equivalent to the following:
BEGIN { require Module; }
Because this is a wide-open interface, pragmas (compiler directives) are also implemented this way. See for descriptions of the currently implemented pragmas. These pseudomodules typically import semantics into the current block scope, unlike ordinary modules, which import symbols into the current package. (The latter are effective through the end of the file.)There's a corresponding declaration,
no
, that "unimports" any meanings originally imported byuse
, but that have since become less important:no integer; no strict 'refs';