Swift Dictionary updateValue(_:forKey:)用法及代碼示例

實例方法

updateValue(_:forKey:)

為給定鍵更新存儲在字典中的值，如果該鍵不存在，則添加一個新的鍵值對。

聲明

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

當 Key 符合 Hashable 時可用。

返回值

被替換的值，如果添加了新的鍵值對，則為 nil。

參數

value: 添加到字典的新值。
key: 與 value 關聯的鍵。如果字典中已存在key，則value 替換現有的關聯值。如果 key 還不是字典的鍵，則添加 (key, value) 對。

詳述

當您需要知道新值是否取代現有鍵的值時，請使用此方法而不是基於鍵的下標。如果更新現有鍵的值，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."

可用版本

iOS 8.0+, iPadOS 8.0+, macOS 10.10+, Mac Catalyst 13.0+, tvOS 9.0+, watchOS 2.0+

相關用法

注：本文由純淨天空篩選整理自apple.com大神的英文原創作品 Dictionary updateValue(_:forKey:)。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。