npt-japanese

% Function ENSURE-DIRECTORIES-EXIST

UP


Function ENSURE-DIRECTORIES-EXIST

Function ENSURE-DIRECTORIES-EXIST

構文

ensure-directories-exist pathspec &key verbose => pathspec, created

引数と戻り値

pathspec - パス名指定子
verbose - generalized-boolean
created - generalized-boolean

定義

指定されたファイルに含まれるディレクトリが 実際に存在するかどうかをテストし、 もし存在しなかったときは作成するよう試みます。

もし含まれているディレクトリが存在せず、 verbosetrueのときは、 実装は標準出力にどのようなディレクトリが生成されたかを 出力することが許されます(しかし必須ではありません)。 もし含まれているディレクトリが存在しているか、 あるいはverbosefalseのときは、 この関数は何も出力しません。

第一返却値は引数のpathspecであり、 この操作が他のファイル操作の式に直接組み込めるようにしています。 第二返却値のcreatedは、 もし何らかのディレクトリが生成された場合はtrueです。

例文

なし。

影響

ホストコンピューターのファイルシステム

例外

pathspecのホスト、デバイス、ディレクトリの部分が ワイルドカードを含んでいるときは、 型file-errorのエラーが発生します。

もしディレクトリの生成の試行が成功しなかったとき、 型file-errorが通知されますが、 もしこのような状況が生じたときに ファイルシステム内で実際に生じたことは、 生成が全く起こらなかったか、 あるいはいくつか生成されたか、 または全ての要求が生成されたか、 いずれかの場合になるでしょう。

参考

probe-file, open, 19.1.2. ファイル名としてのパス名

備考

なし。


TOP, Github