User Tools


Function PROBE-FILE

Syntax

  • probe-file pathspectruename

Arguments and Values

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.

Examples

None.

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

Function TRUENAME, Function OPEN, Function ENSURE-DIRECTORIES-EXIST, System Class PATHNAME, System Class LOGICAL-PATHNAME,{\secref\FileSystemConcepts}, {\secref\OpenAndClosedStreams}, {\secref\PathnamesAsFilenames}

Notes

None.

\issue{PATHNAME-LOGICAL:ADD} \issue{PATHNAME-LOGICAL:ADD} \issue{CLOSED-STREAM-FUNCTIONS:ALLOW-INQUIRY} \issue{FILE-OPEN-ERROR:SIGNAL-FILE-ERROR} \issue{PATHNAME-WILD:NEW-FUNCTIONS} \issue{FILE-OPEN-ERROR:SIGNAL-FILE-ERROR} \issue{PATHNAME-LOGICAL:ADD} \issue{FILE-OPEN-ERROR:SIGNAL-FILE-ERROR}