ToC DocOverview CGDoc RelNotes Index PermutedIndex
Allegro CL
Home Previous Up Next Table of Contents Index
  ANSI Common Lisp   19 Filenames   19.4 Dictionary of Filenames

19.4.7 load-logical-pathname-translations Function

Syntax:
load-logical-pathname-translations host    just-loaded

Arguments and Values:
host - a string.

just-loaded - a generalized boolean.

Description:
Searches for and loads the definition of a logical host named host, if it is not already defined. The specific nature of the search is implementation-defined.

If the host is already defined, no attempt to find or load a definition is attempted, and false is returned. If the host is not already defined, but a definition is successfully found and loaded, true is returned. Otherwise, an error is signaled.

Examples:
 (translate-logical-pathname "hacks:weather;barometer.lisp.newest")
 Error: The logical host HACKS is not defined.
 (load-logical-pathname-translations "HACKS")
;; Loading SYS:SITE;HACKS.TRANSLATIONS
;; Loading done.
 true
 (translate-logical-pathname "hacks:weather;barometer.lisp.newest")
 #P"HELIUM:[SHARED.HACKS.WEATHER]BAROMETER.LSP;0"
 (load-logical-pathname-translations "HACKS")
 false

Exceptional Situations:
If no definition is found, an error of type error is signaled.

See Also:
logical-pathname

Notes:
Logical pathname definitions will be created not just by implementors but also by programmers. As such, it is important that the search strategy be documented. For example, an implementation might define that the definition of a host is to be found in a file called "host.translations" in some specifically named directory.

Allegro CL Implementation Details:
None.

Home Previous Up Next Table of Contents Index
© Franz Inc. 1998-2005 - File last updated 6-21-2002