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

write(toFile:atomically:)

Writes the contents of the array to a file at a given path. 配列の内容をある与えられたパスでのファイルに書き出します。

Declaration 宣言

func write(toFile path: String, 
atomically useAuxiliaryFile: Bool) -> Bool

Parameters パラメータ

path

The path at which to write the contents of the array. それで配列の内容を書き出すことになるパス。

If path contains a tilde (~) character, you must expand it with expandingTildeInPath before invoking this method. pathがチルダ(~)文字を含むならば、あなたはそれをexpandingTildeInPathで、このメソッドを発動する前に展開しなければなりません。

flag

If true, the array is written to an auxiliary file, and then the auxiliary file is renamed to path. If false, the array is written directly to path. The true option guarantees that path, if it exists at all, won’t be corrupted even if the system should crash during writing. trueならば、配列はある補助ファイルに書き出されます、それからその補助ファイルはpathに名前変更されます。falseならば、配列は直接にpathに書き出されます。trueオプションはpathを保証します、それがともかく存在するならば、システムが書き出しの間にクラッシュするとしても。

Return Value 戻り値

true if the file is written successfully, otherwise false. true、もしそのファイルがうまく書き込みされるならば、そうでなければfalse

Discussion 議論

If the array’s contents are all property list objects (NSString, NSData, NSArray, or NSDictionary objects), the file written by this method can be used to initialize a new array with the class method arrayWithContentsOfFile: or the instance method init(contentsOfFile:). This method recursively validates that all the contained objects are property list objects before writing out the file, and returns false if all the objects are not property list objects, since the resultant file would not be a valid property list. 配列の持つ内容が全てプロパティリストオブジェクトであるならば(NSString, NSDataNSArray、またはNSDictionaryオブジェクト)、このメソッドによって書き込まれるファイルは、新しい配列をクラスメソッドarrayWithContentsOfFile:またはインスタンスメソッドinit(contentsOfFile:)で初期化するために使われることができます。このメソッドは、全ての含まれるオブジェクトがプロパティリストオブジェクトであることをファイルに清書する前に再帰的に検証します、そしてfalseをもし全てのオブジェクトがプロパティリストオブジェクトでないならば返します、結果として生じるファイルが有効なプロパティリストでないだろうことから。

See Also 参照

Storing Arrays 配列をソートする

Related Documentation 関連文書