文書 > Swift > Dictionary > updateValue(_:forKey:)

インスタンスメソッド

updateValue(_:forKey:)

与えられたキーの辞書に格納されている値を更新するか、キーが存在しない場合は新しいキー値のペアを追加します。

宣言

@discardableResult mutating func updateValue(_ value: Value, forKey key: Key) -> Value?

パラメータ

value	辞書に追加すべき新しい値。
key	value に関連すべきキー。key が辞書にすでに存在する場合、value は既存の関連値を置き換えます。key がすでに辞書のキーではない場合、(キー、値) のペアが追加されます。

戻り値

置き換えられた値、または新しいキー値のペアが追加された場合は nil。

議論

新しい値が既存のキーの値に取って代わるかどうかを知る必要がある場合は、キーを基礎にしたサブスクリプトの代わりにこのメソッドを使用します。既存のキーの値が更新されると、updateValue(_:forKey:) は元の値を返します。

var hues = ["Heliotrope": 296, "Coral": 16, "Aquamarine": 156]

if let oldValue = hues.updateValue(18, forKey: "Coral") {
    print("The old value of \(oldValue) was replaced with a new one.")
}
// Prints "The old value of 16 was replaced with a new one."

与えられたキーが辞書内に存在しない場合、このメソッドはキー値のペアを追加し、nil を返します。

if let oldValue = hues.updateValue(330, forKey: "Cerise") {
    print("The old value of \(oldValue) was replaced with a new one.")
} else {
    print("No value was found in the dictionary for that key.")
}
// Prints "No value was found in the dictionary for that key."