Movatterモバイル変換

Syntax:

translate-logical-pathnamepathname&key =>physical-pathname

Arguments and Values:

pathname---apathname designator, or alogical pathnamenamestring.

physical-pathname---aphysical pathname.

Description:

Translatespathname to aphysical pathname, which it returns.

Ifpathname is astream, thestream can be either open or closed.translate-logical-pathname returns the same physical pathname after a file is closed as it did when the file was open. It is an error ifpathname is astream that is created withmake-two-way-stream,make-echo-stream,make-broadcast-stream,make-concatenated-stream,make-string-input-stream,make-string-output-stream.

Ifpathname is alogical pathname namestring, the host portion of thelogical pathname namestring and its followingcolon are required.

Pathname is first coerced to apathname. If the coercedpathname is a physical pathname, it is returned. If the coercedpathname is alogical pathname, the first matching translation (according topathname-match-p) of thelogical pathname host is applied, as if by callingtranslate-pathname. If the result is alogical pathname, this process is repeated. When the result is finally a physical pathname, it is returned. If no translation matches, an error is signaled.

translate-logical-pathname might perform additional translations, typically to provide translation of file types to local naming conventions, to accomodate physical file systems with limited length names, or to deal with special character requirements such as translating hyphens to underscores or uppercase letters to lowercase. Any such additional translations areimplementation-defined. Some implementations do no additional translations.

There are no specified keyword arguments fortranslate-logical-pathname, but implementations are permitted to extend it by adding keyword arguments.

Examples:

Seelogical-pathname-translations.

Affected By: None.

Exceptional Situations:

Ifpathname is incorrectly supplied, an error oftypetype-error is signaled.

If no translation matches, an error oftypefile-error is signaled.

See Also:

logical-pathname,logical-pathname-translations,logical-pathname,Section 20.1 (File System Concepts),Section 19.1.2 (Pathnames as Filenames)

Notes: None.

• FILE-OPEN-ERROR:SIGNAL-FILE-ERROR
• PATHNAME-STREAM
• CLOSED-STREAM-OPERATIONS:ALLOW-INQUIRY
• PATHNAME-LOGICAL:ADD