Function Entry: VL-DIRECTORY-FILES
← Prev | ↑ Chapter | Next → | Index | Symbols
Function Entry: VL-DIRECTORY-FILES
Name
vl-directory-files
Class
Visual LISP File Function
Syntax
(vl-directory-files [directory [pattern [directories]]])
Arguments and Values
directory— optional directory pathname; defaults to the current directory when omitted or nil.pattern— optional wildcard pattern; defaults to*.*.directories— optional selector:-1directories only0files and directories (the default, when omitted or nil)1files only
Description
Lists files in a directory, optionally filtered by pattern and directory/file selection.
The entries "." and ".." are directory entries like the others: they
are listed (first) whenever directories are selected (-1 or 0), and
the pattern filters them as it filters any other name, so `""` and
`".*" match them while "*.lsp"` does not.
Return Values
List of strings or nil.
Autodesk documents that only the matching names are returned, not full pathnames.
The order of the entries other than "." and ".." is not specified.
Tested Behaviour
(vl-directory-files nil nil)lists files AND directories,"."and".."first, on AutoCAD 2022 (accoreconsole), BricsCAD V25 (Windows) and BricsCAD V26 (macOS): error-processing catalogue case 464,probes/error-processing/results/raw/, 2026-11-03. The other entries come in name order on AutoCAD, directories first on BricsCAD V25, and in directory order on BricsCAD V26.
Side Effects
None.
Compatibility
Part of the Visual LISP extension layer, but documented as broadly available across Autodesk desktop and web platforms.
Availability
- AutoCAD 2026: documented (per Autodesk reference page).
- AutoCAD 2022, BricsCAD V25 and V26: the
directoriesselector was verified by runtime probe 2026-08-09 —-1returns directories only and1returns files only on every engine, matching the Autodesk signature above. - Status: verified on both vendors (no longer "presumed compatible").
Source Notes
- [vl-directory-files (AutoLISP)](https://help.autodesk.com/cloudhelp/2025/JPN/AutoCAD-AutoLISP-Reference/files/GUID-C28C0CB0-FBBE-4AA8-BAC4-2FF222772514.htm)
- Runtime probe: alpm
tests/verification/verification.lsp(V-6), 2026-08-09.
Notes
- Autodesk documents a Unicode/LISPSYS behavior change in AutoCAD 2021.
clautolisp
clautolisp implementation note – not part of the normative specification
above. Up to clautolisp 2.3.83 the default selector was 1 (files only)
and "." / ".." were never returned; since 2.3.84 clautolisp follows the
three products (divergence case 0, Common: no warning in any dialect).
clautolisp lists "." and "..", then the files, then the
subdirectories. (vl-directory-files-dot-entries-and-default-selector.)