[Chapter 8] 8.103 lib
Author: Ellen Siever, Stephen Spainhour & Nathan Patwardhan
Date: 1999-07-02T01:49:25Z

#

| Chapter 8 Standard Modules |

## 8.103 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;

8.102 less |  | 8.104 locale