CLCS
src report error
Index
directory Files Dictionary ensure-directories-exist
Function

probe-file

probe-file pathspec ⇒ truename

Arguments and Values

pathspeca pathname designator.
truenamea physical pathname or nil.

Description

probe-file tests whether a file exists.

probe-file returns false if there is no file named pathspec, and otherwise returns the truename of pathspec.

If the pathspec designator is an open stream, then probe-file produces the truename of its associated file.

If pathspec is a stream, whether open or closed, it is coerced to a pathname as if by the function pathname.

Affected By

The host computer’s file system.

Exceptional Situations

An error of type file-error is signaled if pathspec is wild.

An error of type file-error is signaled if the file system cannot perform the requested operation.

See Also

truename, open, ensure-directories-exist, pathname,

logical-pathname,

File System Concepts, File Operations on Open and Closed Streams,

Pathnames as Filenames

Backlinks

close, ensure-directories-exist, File Operations on Open and Closed Streams, File System Concepts, file-error, Files Dictionary, Stream Arguments to Standardized Functions, Symbols in the COMMON-LISP Package