Instance Method インスタンスメソッド

createDirectoryAtURL:withIntermediateDirectories:attributes:error:

Creates a directory with the given attributes at the specified URL. 与えられた属性を持つディレクトリを指定されたURLで作成します。

Declaration 宣言 

- (BOOL)createDirectoryAtURL:(NSURL *)url 
 withIntermediateDirectories:(BOOL)createIntermediates 
                  attributes:(NSDictionary<NSFileAttributeKey, id> *)attributes 
                       error:(NSError * _Nullable *)error;

Parameters パラメータ

url

A file URL that specifies the directory to create. If you want to specify a relative path, you must set the current working directory before creating the corresponding NSURL object. This parameter must not be nil. 作成するディレクトリを指定するファイルURL。あなたが相対パスを指定したいならば、あなたは現在の作業ディレクトリを設定しなければなりません、対応するNSURLオブジェクトを作成する前にです。このパラメータは、nilであってはいけません。

createIntermediates

If YES, this method creates any nonexistent parent directories as part of creating the directory in url. If NO, this method fails if any of the intermediate parent directories does not exist. YESならば、このメソッドはあらゆる存在しない親ディレクトリをurlでのディレクトリ作成の一部として作成します。NOならば、このメソッドは中間にある親ディレクトリのどれかが存在しないならば失敗します。

attributes

The file attributes for the new directory. You can set the owner and group numbers, file permissions, and modification date. If you specify nil for this parameter, the directory is created according to the umask(2) macOS Developer Tools Manual Page of the process. The Supporting Types section lists the global constants used as keys in the attributes dictionary. Some of the keys, such as NSFileHFSCreatorCode and NSFileHFSTypeCode, do not apply to directories. 新しいディレクトリに対するファイル属性。あなたは、所有者とグループ番号、ファイル権限、そして修正日を設定できます。あなたがnilをこのパラメータに指定するならば、ディレクトリは、このプロセスのmacOS Developer Tools Manual Page umask(2) により作成されます。サポートする型の節は、attributes辞書においてキーとして使われるグローバル定数を一覧にします。キーのいくつか、 例えばNSFileHFSCreatorCodeとNSFileHFSTypeCodeなどは、ディレクトリに適用されません。

error

On input, a pointer to an error object. If an error occurs, this pointer is set to an actual error object containing the error information. You may specify nil for this parameter if you do not want the error information. 入力では、エラーオブジェクトへのポインタ。エラーが発生するならば、このポインタはエラー情報を含んでいる実際のエラーオブジェクトへと設定されます。あなたは、nilをこのパラメータに対して指定するかもしれません、もしあなたがエラー情報を望まないならば。

Return Value 戻り値

YES if the directory was created, YES if createIntermediates is set and the directory already exists, or NO if an error occurred. ディレクトリが作成されたならばYES、createIntermediatesが設定されてディレクトリが既に存在するならばYES、またはエラーが発生したならばNO。

Discussion 議論

If you specify nil for the attributes parameter, this method uses a default set of values for the owner, group, and permissions of any newly created directories in the path. Similarly, if you omit a specific attribute, the default value is used. The default values for newly created directories are as follows: あなたがnilをattributesパラメータに指定するならば、このメソッドは省略時のひとそろいの値をパスにおいてあらゆる新しく作成されるディレクトリの所有者、グループ、そして権限に対して設定します。同じように、あなたが特定の属性を省くならば、省略時の値が使用されます。新しく作成されるディレクトリに対する省略時の値は以下になります：

  • Permissions are set according to the umask of the current process. For more information, see umask. 権限は、現在のプロセスのumaskに応じて設定されます。さらなる情報として、umaskを見てください。

  • The owner ID is set to the effective user ID of the process. 所有者IDは、現在のプロセスの実効ユーザIDに設定されます。

  • The group ID is set to that of the parent directory. グループIDは、親ディレクトリのそれに設定されます。

If you want to specify a relative path for url, you must set the current working directory before creating the corresponding NSURL object. あなたが相対パスをurlに指定したいならば、あなたは現在の作業ディレクトリを設定しなければなりません、対応するNSURLオブジェクトを作成する前にです。

See Also 参照

Creating and Deleting Items 項目の作成と消去

- createDirectoryAtPath:withIntermediateDirectories:attributes:error:
Creates a directory with given attributes at the specified path. 与えられた属性を持つディレクトリを指定されたパスで作成します。
- createFileAtPath:contents:attributes:
Creates a file with the specified content and attributes at the given location. 指定された内容と属性でファイルをこの与えられた場所で作成します。
- removeItemAtURL:error:
Removes the file or directory at the specified URL. ファイルとディレクトリを指定されたURLで除去します。
- removeItemAtPath:error:
Removes the file or directory at the specified path. ファイルとディレクトリを指定されたパスで除去します。
- trashItemAtURL:resultingItemURL:error:
Moves an item to the trash. 項目をゴミ箱に移動します。

Related Documentation 関連文書

- setAttributes:ofItemAtPath:error:
Sets the attributes of the specified file or directory. 指定されたファイルまたはディレクトリの属性を設定します。