Merges the given dictionary into this dictionary, using a combining closure to determine the value for any duplicate keys.
SDK
- Xcode 10.2+
Framework
- Swift Standard Library
Declaration
mutating func merge(_ other: [Key : Value], uniquingKeysWith combine: (Value, Value) throws -> Value) rethrows
Parameters
otherA dictionary to merge.
combineA closure that takes the current and new values for any duplicate keys. The closure returns the desired value for the final dictionary.
Discussion
Use the combine closure to select a value to use in the updated dictionary, or to combine existing and new values. As the key-values pairs in other are merged with this dictionary, the combine closure is called with the current and new values for any duplicate keys that are encountered.
This example shows how to choose the current or new values for any duplicate keys:
var dictionary = ["a": 1, "b": 2]
// Keeping existing value for key "a":
dictionary.merge(["a": 3, "c": 4]) { (current, _) in current }
// ["b": 2, "a": 1, "c": 4]
// Taking the new value for key "a":
dictionary.merge(["a": 5, "d": 6]) { (_, new) in new }
// ["b": 2, "a": 5, "c": 4, "d": 6]