ToC | DocOverview | CGDoc | RelNotes | Index | PermutedIndex
| Allegro CL

| 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.

© Franz Inc. All Rights Reserved

- File last updated 2022-07-25