Generic Instance Method 総称体インスタンスメソッド

flatMap(_:)

Returns an array containing the non-nil results of calling the given transformation with each element of this sequence. 指定された変換をこのシーケンスの各要素で呼び出す結果で非-nilのものを含んでいる配列を返します。

Declaration 宣言 

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

Parameters パラメータ

transform

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. シーケンスの各要素でtransformを呼ぶことの非nilの結果の配列。

Discussion 解説

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. この例において、mapとflatMapを、オプショナルInt値を返す変換とともに使う結果の違いに注意してください。 


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


let mapped: [Int?] = possibleNumbers.map { 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. 計算量：O(m + n)、ここでmはこのシーケンスの長さで、nは結果の長さです。

See Also 参照

Transforming a Sequence シーケンスを変形する

func map<T>((Self.Element) -> T) -> [T]
Returns an array containing the results of mapping the given closure over the sequence’s elements. 与えられたクロージャをシーケンスのもつ要素全体にわたってマップする結果を含んでいる配列を返します。
func compactMap<ElementOfResult>((Self.Element) -> ElementOfResult?) -> [ElementOfResult]
Returns an array containing the non-nil results of calling the given transformation with each element of this sequence. 指定された変換をこのシーケンスの各要素で呼び出す結果で非-nilのものを含んでいる配列を返します。
func flatMap<SegmentOfResult>((Self.Element) -> SegmentOfResult) -> [SegmentOfResult.Element]
Returns an array containing the concatenated results of calling the given transformation with each element of this sequence. 指定された変換をこのシーケンスの各要素で呼び出す結果を連結したものを含んでいる配列を返します。
func reduce<Result>(Result, (Result, Self.Element) -> Result) -> Result
Returns the result of combining the elements of the sequence using the given closure. 与えられたクロージャを使って、このシーケンスの要素それらを結合する結果を返します。
func reduce<Result>(into: Result, (inout Result, Self.Element) -> ()) -> Result
Returns the result of combining the elements of the sequence using the given closure. 与えられたクロージャを使って、このシーケンスの要素それらを結合する結果を返します。
var lazy: LazySequence<Self>
A sequence containing the same elements as this sequence, but on which some operations, such as map and filter, are implemented lazily. このシーケンスと同じ要素を含んでいるシーケンス、しかしそれの上で何らかの演算、例えばmapやfilterが遅延に実装されます。