Generic Instance Method


Returns an array containing the non-nil results of calling the given transformation with each element of this sequence.


func flatMap<ElementOfResult>(_ transform: (Self.Iterator.Element) throws -> ElementOfResult?) rethrows -> [ElementOfResult]



A closure that accepts an element of this sequence as its argument and returns an optional value.

Return Value

An array of the non-nil results of calling transform with each element of the sequence.


Use this method to receive an array of nonoptional values when your transformation produces an optional value.

In this example, note the difference in the result of using map and flatMap with a transformation that returns an optional Int value.

let possibleNumbers = ["1", "2", "three", "///4///", "5"]

let mapped: [Int?] = { str in Int(str) }
// [1, 2, nil, nil, 5]

let flatMapped: [Int] = possibleNumbers.flatMap { str in Int(str) }
// [1, 2, 5]

Complexity: O(m + n), where m is the length of this sequence and n is the length of the result.