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

write(to:atomically:)

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

Declaration 宣言

func write(to url: URL, 
atomically: Bool) -> Bool

Parameters パラメータ

aURL: The URL to which to write the dictionary. それへと辞書を書き出すことになるURL。
flag: A flag that specifies whether the output should be written atomically. 出力がアトミックに書き出されるべきかどうかを指定するフラグ。

If flag is true, the dictionary is written to an auxiliary location, and then the auxiliary location is renamed to aURL. If flag is false, the dictionary is written directly to aURL. The true option guarantees that aURL, if it exists at all, won’t be corrupted even if the system should crash during writing. flag is ignored if aURL is of a type that cannot be written atomically. flagがtrueならば、辞書は補助位置へ書き出されて、それからその補助位置はaURLに改名されます。flagがfalseならば、辞書はaURLに直接に書き出されます。trueオプションはaURLが、それがともかく存在するならば、破壊されないことをたとえシステムが書き出しの間にクラッシュするとしても保証します。flagは、もしaURLがアトミックに書き出されることができない型のものであるならば無視されます。

Return Value 戻り値

true if the location 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 output 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 location written by this method can be used to initialize a new dictionary with the class method dictionaryWithContentsOfURL: or the instance method init(contentsOf:). 辞書の持つ内容が全てプロパティリストオブジェクトであるならば、このメソッドによって書き込まれる位置は、新しい辞書をクラスメソッドdictionaryWithContentsOfURL:またはインスタンスメソッドinit(contentsOf:)で初期化するために使われることができます。

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を見てください。