create-Directory (プロシージャ)
public {create-Directory
url:Url,
create-missing-parents?:bool = false,
error-if-exists?:bool = true,
create-mode:int = 0o777
}:Directory
パッケージ: CURL.IO.FILE

ファイルシステムにディレクトリを作成します。

url: 新規のディレクトリが作成される場所を識別する Url です。
error-if-exists?: ディレクトリまたはファイルが既に url に存在する場合に例外をスローするかどうかを示す bool フラグです。false の場合は、例外はスローされず、既存のファイルが新規のディレクトリで上書きされます。false の場合、既存のディレクトリはそのままです。
create-missing-parents?: bool フラッグであり、url ディレクトリのすべての親ディレクトリが存在しない場合に作成するかどうかを示します。これが false の場合 (既定)、および存在しない親ディレクトリがある場合、FileException がスローされます。
create-mode: 作成された場合にディレクトリに割り当てられるアクセス権を示します。現在、UNIX システムでは、この引数は mkdir() の呼び出しに単に直接パスされます。UNIX システムでは、最終のファイルプロテクションを実行するため create-mode は umask によって変更されます。

戻り値

ファイルシステムに新規に作成されたディレクトリを表す Directory オブジェクト。

説明

このプロシージャは url の指定された場所にディレクトリを作成し、そのディレクトリを表す Directory オブジェクトを返します。

例外のスロー

PermissionDeniedFileException — ユーザーが url を作成する許可が十分に与えられていない場合。
MissingFileExceptionurl の stem パスにディレクトリが存在せず、create-missing-parents?false の場合。
ExistingFileException — ファイルまたはディレクトリが url に存在し、error-if-exists?true の場合。
FileException — この操作の実行中に何か不具合が発生すると、他の種類の FileException がスローされる場合があります。

注意事項

このプロシージャはアトミックではありません。

error-if-exists? = false を指定してもこのプロシージャが ExistingFileException をスローしないとは限りません。たとえば、別のプロセスが同時に url を作成した場合などにはエラーがスローされます。