|
ANSI Common Lisp  20
Files 20.2 Dictionary of Files
| 20.2.1 directory |
Function |
- Syntax:
- 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, Section 20.1 File System Concepts, Section 21.1.1.1.2 Open and Closed Streams, Section 19.1.2 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.
- Allegro CL Implementation Details:
- See cl-directory implementation in implementation.html for information on the
implementation in Allegro CL, particularly for information on handling of wildcards in the
argument pathname designator.
|
