std-glob-files


Synopsis

(std-glob-files <fspec>)

Description

std-glob-files returns a list of all matching filenames, including their path prefixes, specified by the fspec argument, which might or better should contain wildcards.

The returned path is the specified by the path part of fspec, so it might be relative, absolute or no path at all. However, any returned filename is a valid argument to any file function such as std-fopen.

"Globbing" means expanding wildcards from a filename specifier to a list of matching files. It uses the shell wildcard convention, not the wcmatch wildcards.

Example

(std-glob-files "*L*.lsp")
=> all lisp files containing a "L" in the current directory.

(std-glob-files "C:/ACAD/SUPPORT/*.LSP")
=> ("C:/ACAD/SUPPORT/3D.LSP" "C:/ACAD/SUPPORT/ACADR14.LSP" ...)

Arguments

fspec: a filename specifier which might include wildcards.

Return Value

A list of matching filenames, including path prefixes.

Side Effects

It might shell out to the operating system, if no native function can be used. (plain alisp, no fileext)

Module

(std-require 'STDFILE)

Defined in STDFILE