FlatMap takes a nested collection and flattens it into a single-level collection by extracting and combining inner collections.
Execution Sample
Swift
let nested = [[1, 2], [3, 4], [5]]
let flat = nested.flatMap { $0 }
print(flat)
This code flattens a nested array of integers into a single array.
Execution Table
Step
Action
Input
Output
1
Start with nested array
[[1, 2], [3, 4], [5]]
[[1, 2], [3, 4], [5]]
2
Apply flatMap to first inner array
[1, 2]
[1, 2]
3
Apply flatMap to second inner array
[3, 4]
[1, 2, 3, 4]
4
Apply flatMap to third inner array
[5]
[1, 2, 3, 4, 5]
5
Final flattened array
N/A
[1, 2, 3, 4, 5]
💡 All inner arrays processed and combined into one flat array.
Variable Tracker
Variable
Start
After 1
After 2
After 3
Final
nested
[[1, 2], [3, 4], [5]]
[[1, 2], [3, 4], [5]]
[[1, 2], [3, 4], [5]]
[[1, 2], [3, 4], [5]]
[[1, 2], [3, 4], [5]]
flat
[]
[1, 2]
[1, 2, 3, 4]
[1, 2, 3, 4, 5]
[1, 2, 3, 4, 5]
Key Moments - 3 Insights
Why does flatMap use $0 inside the closure?
Because $0 represents each inner array inside the nested array, flatMap extracts these inner arrays to combine them into one flat array, as shown in execution_table rows 2-4.
Is flatMap the same as map followed by flatten?
Yes, flatMap combines mapping and flattening in one step. Here, flatMap { $0 } is like mapping each inner array to itself and then flattening, as seen in the stepwise output.
What happens if the nested array is empty?
If nested is empty, flatMap returns an empty array immediately, as no inner arrays exist to process, similar to the start state in execution_table row 1.
Visual Quiz - 3 Questions
Test your understanding
Look at the execution_table, what is the value of 'flat' after processing the second inner array?
A[1, 2, 3, 4]
B[3, 4]
C[1, 2]
D[1, 2, 3]
💡 Hint
Check execution_table row 3 under Output column.
At which step does the flat array contain all elements from the nested arrays?
AStep 2
BStep 5
CStep 3
DStep 4
💡 Hint
Look at execution_table row 5 Output column for the final flat array.
If the nested array was [[1], [], [2, 3]], what would flatMap output after processing the second inner array?
A[1, ]
B[1, 2, 3]
C[1]
D] ,1[
💡 Hint
Empty inner arrays add no elements; check how flat changes after each inner array in variable_tracker.
Concept Snapshot
flatMap for nested collections:
- Use flatMap to flatten nested arrays
- Syntax: nested.flatMap { $0 }
- Extracts and combines inner arrays
- Result is a single-level array
- Useful to avoid nested loops
Full Transcript
This visual execution shows how flatMap works on nested collections in Swift. Starting with a nested array of arrays, flatMap takes each inner array ($0) and combines them into one flat array. Step by step, each inner array is appended to the result. Variables 'nested' and 'flat' track the original and flattened arrays. Key moments clarify why $0 is used and how flatMap differs from map. The quiz tests understanding of the flattening process and final output.
Practice
(1/5)
1. What does the flatMap function do when applied to a nested array in Swift?
easy
A. It flattens the nested arrays into a single array by combining all elements.
B. It sorts the nested arrays in ascending order.
C. It removes duplicate elements from the nested arrays.
D. It converts the nested arrays into a dictionary.
Solution
Step 1: Understand the purpose of flatMap
The flatMap function is designed to take a collection of collections and combine them into one single collection by flattening the nested structure.
Step 2: Identify the effect on nested arrays
When applied to nested arrays, flatMap merges all inner arrays into one continuous array containing all elements.
Final Answer:
It flattens the nested arrays into a single array by combining all elements. -> Option A
Quick Check:
flatMap flattens nested arrays = A [OK]
Hint: Remember: flatMap flattens nested arrays into one array [OK]
Common Mistakes:
Thinking flatMap sorts the array
Confusing flatMap with removing duplicates
Assuming flatMap converts arrays to dictionaries
2. Which of the following is the correct syntax to flatten a nested array let nested = [[1, 2], [3, 4]] using flatMap in Swift?
easy
A. let flat = nested.flatten()
B. let flat = nested.map { $0 }
C. let flat = nested.flatMap()
D. let flat = nested.flatMap { $0 }
Solution
Step 1: Recall flatMap syntax
The correct syntax for flattening nested arrays uses flatMap with a closure that returns each inner array: nested.flatMap { $0 }.
Step 2: Evaluate each option
let flat = nested.flatMap { $0 } uses the correct closure syntax. let flat = nested.map { $0 } uses map which does not flatten. let flat = nested.flatMap() is invalid syntax. let flat = nested.flatten() uses a non-existent method flatten().
Final Answer:
let flat = nested.flatMap { $0 } -> Option D
Quick Check:
flatMap with closure { $0 } flattens nested arrays [OK]
Hint: Use flatMap with closure { $0 } to flatten nested arrays [OK]
Common Mistakes:
Using map instead of flatMap
Calling flatMap without closure
Using non-existent flatten() method
3. What is the output of the following Swift code?
let nested = [[1, 2], [3, 4], [5]]
let result = nested.flatMap { $0.map { $0 * 2 } }
print(result)
medium
A. [1, 2, 3, 4, 5]
B. [2, 4, 6, 8, 10]
C. [[2, 4], [6, 8], [10]]
D. [1, 4, 9, 16, 25]
Solution
Step 1: Understand the inner map operation
Each inner array is mapped to a new array where each element is multiplied by 2, so [1,2] becomes [2,4], [3,4] becomes [6,8], and [5] becomes [10].
Step 2: Apply flatMap to flatten the mapped arrays
The flatMap then flattens these arrays into a single array: [2, 4, 6, 8, 10].
Final Answer:
[2, 4, 6, 8, 10] -> Option B
Quick Check:
flatMap + map doubles and flattens = [2,4,6,8,10] [OK]
Hint: flatMap flattens after map transforms inner elements [OK]
Common Mistakes:
Confusing flatMap with map output
Expecting nested arrays instead of flattened
Multiplying elements incorrectly
4. Identify the error in the following Swift code that attempts to flatten a nested array:
let nested = [["a", "b"], ["c"]]
let flat = nested.flatMap()
print(flat)
medium
A. flatMap requires a closure to specify how to flatten the nested arrays.
B. flatMap cannot be used on arrays of strings.
C. The variable 'flat' is immutable and cannot be assigned.
D. The print statement syntax is incorrect.
Solution
Step 1: Check flatMap usage
The flatMap function requires a closure to specify how to flatten the nested arrays, such as { $0 }. Calling flatMap() without arguments is invalid.
Step 2: Verify other parts of the code
Arrays of strings can be flattened with flatMap, variables can be assigned with let, and print syntax is correct.
Final Answer:
flatMap requires a closure to specify how to flatten the nested arrays. -> Option A
Quick Check:
flatMap needs closure { $0 } to flatten [OK]
Hint: Always provide closure { $0 } when using flatMap on nested arrays [OK]
Common Mistakes:
Calling flatMap without closure
Thinking flatMap can't flatten strings
Misunderstanding let variable assignment
Assuming print syntax is wrong
5. Given a nested array of optional integers let nested: [[Int?]] = [[1, nil], [3, 4], [nil]], which Swift code using flatMap correctly produces a flat array of non-nil integers?
hard
A. let flat = nested.flatMap { $0.filter { $0 != nil } }
B. let flat = nested.flatMap { $0.map { $0! } }
C. let flat = nested.flatMap { $0.compactMap { $0 } }
D. let flat = nested.flatMap { $0 }
Solution
Step 1: Understand the data and goal
The nested array contains optional integers, some are nil. The goal is to flatten and remove nil values, keeping only non-nil integers.
Step 2: Analyze each option
let flat = nested.flatMap { $0.compactMap { $0 } } uses compactMap inside flatMap to unwrap and remove nils, then flatten. let flat = nested.flatMap { $0.map { $0! } } force unwraps which can crash if nil exists. let flat = nested.flatMap { $0.filter { $0 != nil } } filters nil but keeps optionals, so result is nested optionals. let flat = nested.flatMap { $0 } just flattens but keeps nils.
Final Answer:
let flat = nested.flatMap { $0.compactMap { $0 } } -> Option C
Quick Check:
flatMap + compactMap unwraps and flattens non-nil values [OK]
Hint: Use compactMap inside flatMap to remove nils and flatten [OK]
Common Mistakes:
Force unwrapping optionals causing runtime errors
Filtering nil but not unwrapping optionals
Flattening without removing nil values
Recommended
Ready to prove it?
Pass the test and this pattern moves unknownstrongwhile earning +1 Grip toward your certificate.