CLCS
src report error
Index
Files Dictionary Files Dictionary probe-file
Function

directory

directory pathspec &key ⇒ pathnames

Arguments and Values

pathspeca pathname designator, which may contain wild components.
pathnamesa 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.

Backlinks

close, File Operations on Open and Closed Streams, File System Concepts, file-error, Files Dictionary, pathname-match-p, Restrictions on Examining a Pathname Directory Component, Restrictions on Wildcard Pathnames, Stream Arguments to Standardized Functions, Symbols in the COMMON-LISP Package