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:)。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。