NEW: Get your ticket to Hacking with Swift Live 2020! >>

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

SPONSORED Why the top iOS apps rely on Instabug for crash reporting. Crash reporting + Bug reporting + Customizable in-app surveys all in one SDK. Know which line of code caused the crash along with network logs, repro steps, and the session profiler to identify and resolve severe crashes quickly. See more detailed features comparison and try Instabug for free here.

Support my work on Patreon

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