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

writeToFile:atomically:

Writes a property list representation of the contents of the dictionary to a given path. 辞書の内容のプロパティリスト表現をある与えられたパスに書き出します。

Declaration 宣言

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

Parameters パラメータ

path: The path at which to write the file. それでファイルが書き出されることになるパス。

If path contains a tilde (~) character, you must expand it with stringByExpandingTildeInPath before invoking this method. pathがチルダ（~）文字を含むならば、あなたはそれをstringByExpandingTildeInPathで、このメソッドを発動する前に展開しなければなりません。
flag: A flag that specifies whether the file should be written atomically. ファイルがアトミックに書き出されるべきかどうかを指定するフラグ。

If flag is YES, the dictionary is written to an auxiliary file, and then the auxiliary file is renamed to path. If flag is NO, the dictionary 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. flagがYESならば、辞書はある補助ファイルに書き出されます、それからその補助ファイルはpathに名前変更されます。flagがNOならば、辞書はpathに直接に書き出されます。YESオプションはpathを保証します、それがともかく存在するならば、システムが書き出しの間にクラッシュするとしても。

Return Value 戻り値

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

Discussion 議論

This method recursively validates that all the contained objects are property list objects (instances of NSData, NSDate, NSNumber, NSString, NSArray, or NSDictionary) 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. このメソッドは、全ての含まれるオブジェクトがプロパティリストオブジェクト（NSData、NSDate、NSNumber、NSString、NSArray、またはNSDictionaryのインスタンス）であることをファイルに清書する前に再帰的に検証します、そしてNOをもし全てのオブジェクトがプロパティリストオブジェクトでないならば返します、結果として生じるファイルが有効なプロパティリストでないだろうことから。

If the dictionary’s contents are all property list objects, the file written by this method can be used to initialize a new dictionary with the class method dictionaryWithContentsOfFile: or the instance method initWithContentsOfFile:. 辞書の持つ内容が全てプロパティリストオブジェクトであるならば、このメソッドによって書き込まれるファイルは、新しい辞書をクラスメソッドdictionaryWithContentsOfFile:またはインスタンスメソッドinitWithContentsOfFile:で初期化するために使われることができます。

If you need greater control over the property list representation, use NSPropertyListSerialization instead. あなたがより大きな制御をプロパティリスト表現について必要とするならば、NSPropertyListSerializationを代わりに使ってください。

For more information about property lists, see Property List Programming Guide. プロパティリストについてのさらなる情報として、Property List Programming Guideを見てください。