npt-japanese

% Function TRANSLATE-LOGICAL-PATHNAME

UP


Function TRANSLATE-LOGICAL-PATHNAME

Function TRANSLATE-LOGICAL-PATHNAME

構文

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

引数と戻り値

pathname - パス名指定子か、論理パス名の名前文字列。
physical-pathname - 物理パス名

定義

pathnameを物理パス名に変換し返却します。

もしpathnameがストリームのとき、 そのストリームは開いているものか閉じているものを指定できます。 translate-logical-pathnameは ファイルがクローズされたあとのものについては、 ファイルが開いているときに実行されたものと同じ論理パス名を返却します。 もしpathnameがストリームであり、 make-two-way-stream, make-echo-stream, make-broadcast-stream, make-concatenated-stream, make-string-input-stream, make-string-output-stream によって作成されたもののときはエラーが発生します。

もしpathnameが論理パス名の名前文字列であるときは、 それはホストの要素と合わせてコロンが続くものを含まなければなりません。

pathnameは、最初にパス名に変換されます。 もし変換されたpathnameが物理パス名のときは、それが返却されます。 もし変換されたpathnameが論理パス名のときは、 translate-pathnameが呼び出されたかのように、 論理パス名のホストの最初にマッチした変換 (pathname-match-pに従って)が適用されます。 もし結果が論理パス名のとき、この処理は繰り返し行われます。 結果が最終的に物理パス名になったとき、それが返却されます。 もしどの変換にもマッチしなかったとき、エラーが通知されます。

translate-logical-pathnameは追加の変換を行うことがあり、 典型的にはローカルな命名規則に合わせてファイルのタイプを変換したり、 物理ファイルシステムの名前の長さに制限がある場合に対応したり、 ハイフンをアンダースコアに、 大文字を小文字に変換するような 特殊文字の要件に対応するなどを行います。 このような追加の変換は実装定義のものです。 実装によっては追加の変換を行いません。

translate-logical-pathnameにはキーワード引数はありませんが、 しかし実装は追加のキーワード引数による拡張が許されます。

例文

See logical-pathname-translations

影響

なし。

例外

もしpathnameに不正なものが与えられたとき、 型type-errorのエラーが発生します。

もしどの返還にもマッチしないとき、 型file-errorのエラーが発生します。

参考

logical-pathname, logical-pathname-translations, logical-pathname, 20.1. ファイルシステムの説明, 19.1.2. ファイル名としてのパス名

備考

なし。


TOP, Github