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

write(toFile:atomically:)

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

Declaration 宣言

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

Parameters パラメータ

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

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

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

Return Value 戻り値

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

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 false 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のインスタンス）であることをファイルに清書する前に再帰的に検証します、そしてfalseをもし全てのオブジェクトがプロパティリストオブジェクトでないならば返します、結果として生じるファイルが有効なプロパティリストでないだろうことから。

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 init(contentsOfFile:). 辞書の持つ内容が全てプロパティリストオブジェクトであるならば、このメソッドによって書き込まれるファイルは、新しい辞書をクラスメソッドdictionaryWithContentsOfFile:またはインスタンスメソッドinit(contentsOfFile:)で初期化するために使われることができます。

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

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