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

write(to:)

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

Declaration 宣言

func write(to url: URL) throws

Parameters パラメータ

url

The URL to which to write the dictionary. それへと辞書を書き出すことになるURL。

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. The method throws an error if all the objects are not property list objects, because the resulting output wouldn’t be a valid property list. このメソッドは、全ての含まれるオブジェクトがプロパティリストオブジェクト(NSDataNSDateNSNumberNSStringNSArray、またはNSDictionaryのインスタンス)であることをファイルに書き出す前に再帰的に検証します。このメソッドはエラーをスローします、もし全てのオブジェクトがプロパティリストオブジェクトでないならば、なぜなら結果出力は有効なプロパティリストでないだろうためです。

If the dictionary’s contents are all property list objects, you can use the location written by this method to initialize a new dictionary with the instance method init(contentsOf:). 辞書のもつ内容が全てプロパティリストオブジェクトならば、あなたはこのメソッドによって書き出された場所を使って、新しい辞書をインスタンスメソッド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を見てください。

See Also 参照

Storing Dictionaries 辞書をソートする