||ANSI Common Lisp 20
Files 20.2 Dictionary of Files
- directory pathspec &key pathnames
- Arguments and Values:
- pathspec - a pathname
designator, which may contain wild
pathnames - a list
of physical pathnames.
- 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
- See Also:
- pathname, logical-pathname,
ensure-directories-exist, Section 20.1 File System Concepts, Section 18.104.22.168.2 Open and Closed Streams, Section 19.1.2 Pathnames as Filenames
- 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.
- Allegro CL Implementation Details:
- See cl-directory in implementation.htm for information on the
implementation in Allegro CL, particularly for information on handling of wildcards in the
argument pathname designator.
© Franz Inc. 1998-2009 - File last updated 7-21-2009