probe-file
probe-file pathspec → truename
pathspec—a pathname designator.
truename—a physical pathname or nil.
probe-file tests whether a file exists.
23.3.0 12probe-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. !!! Sandra wonders if the following is implied by "pathname designator": If pathspec is a stream, whether open or closed, it is coerced to a pathname as if by the function pathname.
None.
The host computer's file system.
An error of type file-error is signaled if pathspec is wild.
Wording changed per x3j13 (05-Oct-93) -kmp
If the probe attempt is not successful,
an error \oftype{file-error} is signaled.An error of type file-error is signaled if the file system cannot perform the requested operation.
truename, open, ensure-directories-exist, pathname, logical-pathname, Section 20.1 (File System Concepts), Section 21.1.1.1.2 (Open and Closed Streams), Section 19.1.2 (Pathnames as Filenames)
None.