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

writeToFile:atomically:

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

Declaration 宣言

- (BOOL)writeToFile:(NSString *)path 
         atomically:(BOOL)useAuxiliaryFile;

Parameters パラメータ

path

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

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

flag

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

Return Value 戻り値

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

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 initWithContentsOfFile:. This method recursively validates that all the contained objects are property list objects before writing out the file, and returns NO if all the objects are not property list objects, since the resultant file would not be a valid property list. 配列の持つ内容が全てプロパティリストオブジェクトであるならば(NSString, NSDataNSArray、またはNSDictionaryオブジェクト)、このメソッドによって書き込まれるファイルは、新しい配列をクラスメソッドarrayWithContentsOfFile:またはインスタンスメソッドinitWithContentsOfFile:で初期化するために使われることができます。このメソッドは、全ての含まれるオブジェクトがプロパティリストオブジェクトであることをファイルに清書する前に再帰的に検証します、そしてNOをもし全てのオブジェクトがプロパティリストオブジェクトでないならば返します、結果として生じるファイルが有効なプロパティリストでないだろうことから。

See Also 参照

Storing Arrays 配列をソートする

Related Documentation 関連文書