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

createFile(atPath:contents:attributes:)

Creates a file with the specified content and attributes at the given location. 指定された内容と属性でファイルをこの与えられた場所で作成します。

Declaration 宣言 

func createFile(atPath path: String, 
       contents data: Data?, 
     attributes attr: [FileAttributeKey : Any]? = nil) -> Bool

Parameters パラメータ

path

The path for the new file. 新しいファイルに対するパス。

contents

A data object containing the contents of the new file. 新しいファイルの内容を含んでいるデータオブジェクト。

attributes

A dictionary containing the attributes to associate with the new file. You can use these attributes to set the owner and group numbers, file permissions, and modification date. For a list of keys, see FileAttributeKey. If you specify nil for attributes, the file is created with a set of default attributes. 新しいファイルと結び付けられる属性を含んでいる辞書。あなたは、これらの属性を使って、所有者とグループ番号、ファイル権限、そして修正日を設定できます。キーの一覧として、FileAttributeKeyを見てください。あなたがnilをattributesに指定するならば、ファイルは一揃いの省略時の属性で作成されます。

Return Value 戻り値

true if the operation was successful or if the item already exists, otherwise false. 操作が成功したならばまたは項目が既に存在するならばtrue、そうでなければfalse。

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 files 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 a file already exists at path, this method overwrites the contents of that file if the current process has the appropriate privileges to do so. ファイルが既にpathで存在するならば、このメソッドはそのファイルの内容を上書きします、もし現在のプロセスがそうするのに適切な特権を持つならば。

See Also 参照

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

func createDirectory(at: URL, withIntermediateDirectories: Bool, attributes: [FileAttributeKey : Any]?)
Creates a directory with the given attributes at the specified URL. 与えられた属性を持つディレクトリを指定されたURLで作成します。
func createDirectory(atPath: String, withIntermediateDirectories: Bool, attributes: [FileAttributeKey : Any]?)
Creates a directory with given attributes at the specified path. 与えられた属性を持つディレクトリを指定されたパスで作成します。
func removeItem(at: URL)
Removes the file or directory at the specified URL. ファイルとディレクトリを指定されたURLで除去します。
func removeItem(atPath: String)
Removes the file or directory at the specified path. ファイルとディレクトリを指定されたパスで除去します。
func trashItem(at: URL, resultingItemURL: AutoreleasingUnsafeMutablePointer<NSURL?>?)
Moves an item to the trash. 項目をゴミ箱に移動します。

Related Documentation 関連文書

func attributesOfItem(atPath: String) -> [FileAttributeKey : Any]
Returns the attributes of the item at a given path. 与えられたパスでの項目の属性を返します。
func contents(atPath: String) -> Data?
Returns the contents of the file at the specified path. 指定されたパスでのファイルの内容を返します。
func setAttributes([FileAttributeKey : Any], ofItemAtPath: String)
Sets the attributes of the specified file or directory. 指定されたファイルまたはディレクトリの属性を設定します。
struct FileAttributeKey
Keys in dictionaries used to get and set file attributes. ファイル属性を取得および設定するのに使われる辞書の中のキー。