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

set(_:forKey:)

Sets a data object for the specified key in the key-value store. データオブジェクトをこの指定されたキーに対してキー値保管において設定します。

Declaration 宣言 

func set(_ aData: Data?, 
  forKey aKey: String)

Parameters パラメータ

aData

The data object to store. The total size of this data object (including any object overhead) must not exceed 1 MB. 格納することになるデータオブジェクト。このデータオブジェクトの全体の大きさは（何らかのオブジェクトオーバーヘッドを含めて）１MBを越えてはいけません。

aKey

The key under which to store the value. The length of this key must not exceed 64 bytes using UTF8 encoding. それの下で値を格納することになるキー。このキーの長さは、UTF8符号化を使って64バイトを越えてはいけません。

Discussion 議論

Using an NSData object as a value in key-value storage lets you store arbitrary data. For example, in a game app, you can use it to store game state to iCloud. NSDataオブジェクトをある値としてキー値保管の中で使うことは、あなたに随意のデータを格納させます。例えば、あるゲームアプリにおいて、あなたはそれを使ってゲームの状態をiCloudに格納できます。

Be sure to exercise caution when storing a data object. Because it is available to be read and modified by every instance of your app attached to a user’s iCloud account, some of which may be older versions or running on another platform, you must diligently protect a data object’s integrity. For more information, see “Exercise Caution When Using NSData Objects as Values” in iCloud Design Guide. データオブジェクトを格納している時に注意を働かせることを必ずしてください。なぜならそれが読み出される及び修正されることは、ユーザのiCloudアカウントに結びつけられたあなたのアプリのあらゆるインスタンスによって可能だからです、それらのあるものはより古いバージョンであるまたは別のプラットホーム上で動作しているかもしれません、あなたはあるデータオブジェクトの無欠性を入念に保護しなければなりません。さらなる情報として、“Exercise Caution When Using NSData Objects as Values” をiCloud Design Guideで見てください。

See Also 参照

Setting Values 値を設定する

func set([Any]?, forKey: String)
Sets an array object for the specified key in the key-value store. 配列オブジェクトをこの指定されたキーに対してキー値保管において設定します。
func set(Bool, forKey: String)
Sets a Boolean value for the specified key in the key-value store. ブール値をこの指定されたキーに対してキー値保管において設定します。
func set([String : Any]?, forKey: String)
Sets a dictionary object for the specified key in the key-value store. 辞書オブジェクトをこの指定されたキーに対してキー値保管において設定します。
func set(Double, forKey: String)
Sets a double value for the specified key in the key-value store. double値をこの指定されたキーに対してキー値保管において設定します。
func set(Int64, forKey: String)
Sets a long long value for the specified key in the key-value store. long long値をこの指定されたキーに対してキー値保管において設定します。
func set(Any?, forKey: String)
Sets an object for the specified key in the key-value store. オブジェクトをこの指定されたキーに対してキー値保管において設定します。
func set(String?, forKey: String)
Sets a string object for the specified key in the key-value store. 文字列をこの指定されたキーに対してキー値保管において設定します。