Subscript

subscript(_:)

Accesses the value associated with the given key for reading and writing. 与えられたキーに結び付けられる値に読出しと書き込みのためにアクセスします。

Declaration 宣言

subscript(key: Key) -> Value? { get set }

Parameters パラメータ

key

The key to find in the dictionary. このキーが辞書において捜されます。

Return Value 戻り値

The value associated with key if key is in the dictionary; otherwise, nil. keyと結び付けられた値、keyが辞書の中にあるならば;そうでなければ、nil

Discussion 解説

This key-based subscript returns the value for the given key if the key is found in the dictionary, or nil if the key is not found. このキー基盤の添え字は、そのキーが辞書において見つけられるならば指定されたキーに対する値を、またはキーが見つからないならばnilを返します。

The following example creates a new dictionary and prints the value of a key found in the dictionary ("Coral") and a key not found in the dictionary ("Cerise"). 以下の例は新しい辞書を作成して、辞書に見つかるキー("Coral")と辞書に見つからないキー("Cerise")の値を出力します


var hues = ["Heliotrope": 296, "Coral": 16, "Aquamarine": 156]
print(hues["Coral"])
// Prints "Optional(16)"
print(hues["Cerise"])
// Prints "nil"

When you assign a value for a key and that key already exists, the dictionary overwrites the existing value. If the dictionary doesn’t contain the key, the key and value are added as a new key-value pair. あなたがある値をあるキーに割り当てるそしてそのキーが既に存在する場合、辞書は既存の値を上書きします。辞書がそのキーを含まないならば、キーと値は新しいキー値ペアとして加えられます。

Here, the value for the key "Coral" is updated from 16 to 18 and a new key-value pair is added for the key "Cerise". ここでは、キー"Coral"に対する値が16から18に更新され、そして新しいキー値ペアがキー"Cerise"に対して加えられます。


hues["Coral"] = 18
print(hues["Coral"])
// Prints "Optional(18)"


hues["Cerise"] = 330
print(hues["Cerise"])
// Prints "Optional(330)"

If you assign nil as the value for the given key, the dictionary removes that key and its associated value. あなたが与えられたキーに値としてnilを割り当てるならば、辞書はそのキーとそれの結び付けられた値を削除します。

In the following example, the key-value pair for the key "Aquamarine" is removed from the dictionary by assigning nil to the key-based subscript. 以下の例において、"Aquamarine"に対するキー値ペアは、nilをキー基盤の添え字に割り当てることによって辞書から削除されます。


hues["Aquamarine"] = nil
print(hues)
// Prints "["Coral": 18, "Heliotrope": 296, "Cerise": 330]"

See Also 参照

Accessing Keys and Values キーと値にアクセスする