lib
Permits adding additional directories to Perl's default search path at compile time. The directories are added at the front of the search path.
use lib list;
adds the directories specified in
list
to @INC
.
For each directory $dir in list
, lib
looks for an architecture-specific subdirectory that has an auto subdirectory under it-that is, it looks for $dir/$archname/auto. If it finds that directory, then $dir/$archname is also added to the front of @INC
, preceding $dir.
Normally, you should only add directories to @INC
. However, you can also delete directories. The statement:
no lib list
deletes the first instance of each named directory from
@INC
. To delete all instances of all the specified names from @INC
, specify :ALL
as the first parameter of list
.
As with adding directories, lib
checks for a directory called $dir/$archname/auto and deletes the $dir/$archname directory from @INC
. You can restore @INC
to its original value with:
@INC = @lib::ORIG_INC;