What are KeyValuePairs?
Swift version: 5.6
KeyValuePairs, somewhat confusingly known as DictionaryLiteral before Swift 5.0, is a useful data type that provides dictionary-like functionality with a handful of benefits:
- Your keys don’t need to conform to
Hashable. - You can add items with duplicate keys.
- The order in which you add items is preserved.
However, because KeyValuePairs doesn’t require its keys to be hashable, you don’t get the fast key look up of a regular dictionary – it’s O(n) rather than O(1) if you like Big O notation. Instead, you access them like an array, using numerical indexes.
As an example, here’s a KeyValuePairs instance holding the name of a singer:
let singer: KeyValuePairs = ["firstName": "Taylor", "lastName": "Swift"]If we wanted to access the key name and value for the first item, we’d write something like this:
print("\(singer[0].key) is set to \(singer[0].value)")Even better, because KeyValuePairs inherits from the Sequence protocol we can loop over all keys and values, like this:
for value in singer {
print("\(value.key) is set to \(value.value)")
}
SAVE 50% To celebrate WWDC23, all our books and bundles are half price, so you can take your Swift knowledge further without spending big! Get the Swift Power Pack to build your iOS career faster, get the Swift Platform Pack to builds apps for macOS, watchOS, and beyond, or get the Swift Plus Pack to learn advanced design patterns, testing skills, and more.
Available from iOS 8.0
Similar solutions…
- How to convert a string to a float
- What are lazy variables?
- How to check whether a date is inside a date range
- What are keypaths?
- How to use reduce() to condense an array into a single value
About the Swift Knowledge Base
This is part of the Swift Knowledge Base, a free, searchable collection of solutions for common iOS questions.
