FREE: Read a new Swift article every day – click here! >>

What are KeyValuePairs?

Paul Hudson       @twostraws

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)")
}

Available from iOS 8.0

Did this solution work for you? Please pass it on!

Other people are reading…

About the Swift Knowledge Base

This is part of the Swift Knowledge Base, a free, searchable collection of solutions for common iOS questions.

Swift on the server is here

Get ahead of the game and learn server-side Swift with my latest book – build real-world projects while you learn!

MASTER SWIFT NOW
Buy Testing Swift Buy Practical iOS 12 Buy Pro Swift Buy Swift Design Patterns Buy Swift Coding Challenges Buy Server-Side Swift (Vapor Edition) Buy Server-Side Swift (Kitura Edition) Buy Hacking with macOS Buy Advanced iOS Volume One Buy Advanced iOS Volume Two Buy Hacking with watchOS Buy Hacking with tvOS Buy Hacking with Swift Buy Dive Into SpriteKit Buy Swift in Sixty Seconds Buy Objective-C for Swift Developers Buy Beyond Code

Was this page useful? Let me know!

Click here to visit the Hacking with Swift store >>