XCode 11.3.1 日本語化計画：Dictionary

文書   >   Swift   >   Dictionary   >   subscript(_:)

サブスクリプト

subscript(_:)

読み取りおよび書き込みのために、与えられたキーに関連した値にアクセスします。

宣言

パラメータ

戻り値

key が辞書内にある場合、key に関連した値。それ以外の場合、nil。

議論

このキーを基礎としたサブスクリプトは、キーが辞書内に見つかった場合は与えられたキーの値を返し、キーが見つからなかった場合は nil を返します。

以下の例では、新しい辞書を作成し、辞書内にあるキーの値 ("Coral") と辞書内に見つからないキー("Cerise") の値を出力します。

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

キーに値を割り当て、そのキーが既に存在する場合、辞書は既存の値を上書きします。辞書にキーが含まれていない場合、キーと値は新しいキー値のペアとして追加されます。

ここでは、キー "Coral" の値が 16 から 18 に更新され、キー "Cerise" に新しいキー値のペアが追加されます。

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

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

与えられたキーの値として nil を割り当てると、辞書はそのキーとそれに関連した値を削除します。

以下の例では、キー "Aquamarine" のキー値のペアは、キーを基礎としたサブスクリプトに nil を割り当てることにより、辞書から削除されます。

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

以下も見よ

キーと値へのアクセス

subscript(Key, default: () -> Value) -> Value




与えられたキーで値にアクセスします。辞書に与えられたキーが含まれていない場合、キーとデフォルト値が辞書に存在するかのように、提供されたデフォルト値にアクセスします。




func index(forKey: Key) -> Dictionary<Key, Value>.Index?




与えられたキーのインデックスを返します。




subscript(Dictionary<Key, Value>.Index) -> Dictionary<Key, Value>.Element




指定された位置にあるキー値のペアにアクセスします。




var keys: Dictionary<Key, Value>.Keys




辞書のキーだけを含むコレクション。




var values: Dictionary<Key, Value>.Values




辞書の値だけを含むコレクション。




var first: (key: Key, value: Value)?




コレクションの最初の要素。




func randomElement() -> (key: Key, value: Value)?




コレクションのランダムな要素を返します。




func randomElement<T>(using: inout T) -> (key: Key, value: Value)?




与えられた発生器を乱数のソースとして使用して、コレクションのランダム要素を返します。

SDK

フレームワーク