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

createDirectoryAtPath:withIntermediateDirectories:attributes:error:

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

Declaration 宣言 

- (BOOL)createDirectoryAtPath:(NSString *)path 
  withIntermediateDirectories:(BOOL)createIntermediates 
                   attributes:(NSDictionary<NSFileAttributeKey, id> *)attributes 
                        error:(NSError * _Nullable *)error;

Parameters パラメータ

path

A path string identifying the directory to create. You may specify a full path or a path that is relative to the current working directory. This parameter must not be nil. 作成するディレクトリを識別するパス文字列。あなたは、完全なパスまたは現在の作業ディレクトリに相対的なパスを指定するかもしれません。このパラメータは、nilであってはいけません。

createIntermediates

If YES, this method creates any non-existent parent directories as part of creating the directory in path. If NO, this method fails if any of the intermediate parent directories does not exist. This method also fails if any of the intermediate path elements corresponds to a file and not a directory. YESならば、このメソッドは何らかの現存しない親ディレクトリをpathにおけるディレクトリ作成の一部として作成します。NOならば、このメソッドは中間にある親ディレクトリのどれかが存在しないならば失敗します。このメソッドはまた、中間にあるパス要素のどれかがファイルに相当するかディレクトリでないならば失敗します。

attributes

The file attributes for the new directory and any newly created intermediate directories. You can set the owner and group numbers, file permissions, and modification date. If you specify nil for this parameter or omit a particular value, one or more default values are used as described in the discussion. For a list of keys you can include in this dictionary, see Supporting Types. Some of the keys, such as NSFileHFSCreatorCode and NSFileHFSTypeCode, do not apply to directories. 新しいディレクトリおよび新しく作成された中間ディレクトリに対するファイル属性。あなたは、所有者とグループ番号、ファイル権限、そして修正日を設定できます。あなたがnilをこのパラメータに指定するか特定の値を省くならば、１つ以上の省略時の値が、議論において記述されるように使用されます。あなたがこの辞書に含めることができるキーの一覧として、支援を行う型を見てください。キーのいくつか、 例えば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は、親ディレクトリのそれに設定されます。

See Also 参照

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

- createDirectoryAtURL:withIntermediateDirectories:attributes:error:
Creates a directory with the given attributes at the specified URL. 与えられた属性を持つディレクトリを指定されたURLで作成します。
- 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. 指定されたファイルまたはディレクトリの属性を設定します。