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

addRegularFile(withContents:preferredFilename:)

Creates a regular-file file wrapper with the given contents and adds it to the receiver, which must be a directory file wrapper. 与えられた内容を持つ通常ファイルファイルラッパーを作成してそれをレシーバに加えます、それはディレクトリファイルラッパーでなければなりません。

Declaration 宣言

func addRegularFile(withContents data: Data, 
  preferredFilename fileName: String) -> String

Parameters パラメータ

data: Contents for the new regular-file file wrapper. 新しい通常ファイルラッパーに対する内容。
filename: Preferred filename for the new regular-file file wrapper. 新しい通常ファイルファイルラッパーに対する優先ファイル名。

Return Value 戻り値

Dictionary key used to store the new file wrapper in the directory’s list of file wrappers. The dictionary key is a unique filename, which is the same as the passed-in file wrapper's preferred filename unless that name is already in use as a key in the directory's dictionary of children. See Accessing File Wrapper Identities in File System Programming Guide for more information about the file-wrapper list structure. 新しいファイルラッパーをディレクトリの持つファイルラッパーのリストに格納するために使われる辞書キー。辞書キーは特有なファイル名です、それは中に渡されたファイルラッパーの持つ優先ファイル名と同じです、ディレクトリの持つ、子らからなる辞書の中のあるキーとして、既にその名前が使用中でない限りは。ファイルラッパーリスト構造についてのさらなる情報としてAccessing File Wrapper IdentitiesをFile System Programming Guideで見てください。

Discussion 議論

This is a convenience method. The default implementation allocates a new file wrapper, initializes it with init(regularFileWithContents:), set its preferredFilename property, adds it to the directory with addFileWrapper(_:), and returns what addFileWrapper(_:) returned. これは便宜メソッドです。省略時の実装は、新しいファイルラッパーをアロケートします、それをinit(regularFileWithContents:)で初期化します、それのpreferredFilenameプロパティを設定します、それをディレクトリにaddFileWrapper(_:)を使って加えます、そしてaddFileWrapper(_:)が返した何かを返します。

Special Considerations 特別な注意事項

This method raises NSInternalInconsistencyException if the receiver is not a directory file wrapper. このメソッドは、レシーバがディレクトリファイルラッパーでないならば、NSInternalInconsistencyExceptionを引き起こします。

This method raises NSInvalidArgumentException if you pass nil or an empty value for filename. このメソッドは、NSInvalidArgumentExceptionを引き起こします、もしあなたがnilまたは空の値をfilenameに渡すならば。