directory (ANSI and GNU Common Lisp Document)

Next: probe-file, Previous: Files Dictionary, Up: Files Dictionary

#### 20.2.1 directory [Function]

`directory` pathspec &key ⇒ pathnames

#### Arguments and Values::

pathspec—a pathname designator, which may contain wild components.

pathnames—a list of

physical pathnames.

#### Description::

Determines which, if any, files that are present in the file system have names matching pathspec, and returns a

fresh

list of pathnames corresponding to the truenames of those files.

An implementation may be extended to accept implementation-defined keyword arguments to directory.

#### Affected By::

The host computer’s file system.

#### Exceptional Situations::

If the attempt to obtain a directory listing is not successful, an error of type file-error is signaled.

#### See Also::

pathname,

logical-pathname,

ensure-directories-exist , File System Concepts, File Operations on Open and Closed Streams,

Pathnames as Filenames

#### Notes::

If the pathspec is not wild, the resulting list will contain either zero or one elements.

Common Lisp specifies “&key” in the argument list to directory even though no standardized keyword arguments to directory are defined. “`:allow-other-keys t`” may be used in conforming programs in order to quietly ignore any additional keywords which are passed by the program but not supported by the implementation.