NEW: Join my free 100 Days of SwiftUI challenge today! >>

What are KeyValuePairs?

Swift version: 5.1

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

LEARN SWIFTUI FOR FREE I have a massive, free SwiftUI video collection on YouTube teaching you how to build complete apps with SwiftUI – check it out!

Available from iOS 8.0

Similar solutions…

About the Swift Knowledge Base

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

BUY OUR BOOKS
Buy Pro Swift Buy Swift Design Patterns Buy Testing Swift Buy Hacking with iOS Buy Swift Coding Challenges Buy Swift on Sundays Volume One Buy Server-Side Swift (Vapor Edition) Buy Advanced iOS Volume One Buy Advanced iOS Volume Two Buy Advanced iOS Volume Three Buy Hacking with watchOS Buy Hacking with tvOS Buy Hacking with macOS Buy Dive Into SpriteKit Buy Swift in Sixty Seconds Buy Objective-C for Swift Developers Buy Server-Side Swift (Kitura Edition) Buy Beyond Code

Was this page useful? Let us know!

Average rating: 4.3/5