Swift version: 5.6
The flatMap()
method of optionals allows you to transform the optional if it has a value, or do nothing if it is empty. This makes for shorter and more expressive code than doing a regular unwrap, and doesn’t require you to change your data type.
Using flatMap()
with optionals is similar to using map()
, with one important difference: if your transformation closure returns an optional, flatMap()
will combine that optional with the existing optional, whereas map()
will keep them both.
Here’s a practical example so you can see the difference:
let stringNumber: String? = "5"
let intNumber = stringNumber.map { Int($0) }
When that code runs, intNumber
will be an Int??
– an optional optional integer. This is because we already have optionality from stringNumber
, and the Int
initializer from a string also returns an optional, so map()
just puts them together.
In comparison, flatMap()
acts differently:
let flatMapNumber = stringNumber.flatMap { Int($0) }
That will return a regular Int?
, meaning that either the whole thing exists or nothing exists – it’s easier to work with.
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 – learn more in my book Pro Swift
This is part of the Swift Knowledge Base, a free, searchable collection of solutions for common iOS questions.
Link copied to your pasteboard.