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

flatMap(_:)

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

Declaration 宣言 

func flatMap<SegmentOfResult>(_ transform: ((key: Key, value: Value)) throws -> SegmentOfResult) rethrows -> [SegmentOfResult.Element] where SegmentOfResult : Sequence

Parameters パラメータ

transform

A closure that accepts an element of this sequence as its argument and returns a sequence or collection. あるクロージャ、それはこのシーケンスのひとつの要素をそれの引数として受け取って、あるシーケンスまたはコレクションを返すものです。

Return Value 戻り値

The resulting flattened array. 結果として生じる平たくされた配列。

Discussion 解説

Use this method to receive a single-level collection when your transformation produces a sequence or collection for each element. あなたの変換が各要素に対してひとつのシーケンスまたはコレクションを生成する場合に、このメソッドを使って単一水準コレクションを受け取ってください。

In this example, note the difference in the result of using map and flatMap with a transformation that returns an array. この例において、mapとflatMapをある配列を返す変換とともに使うことの結果における違いに注意してください。 


let numbers = [1, 2, 3, 4]


let mapped = numbers.map { Array(repeating: $0, count: $0) }
// [[1], [2, 2], [3, 3, 3], [4, 4, 4, 4]]


let flatMapped = numbers.flatMap { Array(repeating: $0, count: $0) }
// [1, 2, 2, 3, 3, 3, 4, 4, 4, 4]

In fact, s.flatMap(transform) is equivalent to Array(s.map(transform).joined()). 実際のところ、s.flatMap(transform)はArray(s.map(transform).joined())に等しいです。

Complexity: O(m + n), where n is the length of this sequence and m is the length of the result. 計算量：O(m + n)、ここでnはこのシーケンスの長さで、mは結果の長さです。

See Also 参照

Transforming a Dictionary 辞書の変形

func mapValues<T>((Value) -> T) -> Dictionary<Key, T>
Returns a new dictionary containing the keys of this dictionary with the values transformed by the given closure. 与えられたクロージャによって変形された値とともに、この辞書のキーを含んでいる新しい辞書を返します。
func reduce<Result>(Result, (Result, (key: Key, value: Value)) -> Result) -> Result
Returns the result of combining the elements of the sequence using the given closure. 与えられたクロージャを使って、このシーケンスの要素それらを結合する結果を返します。
func reduce<Result>(into: Result, (inout Result, (key: Key, value: Value)) -> ()) -> Result
Returns the result of combining the elements of the sequence using the given closure. 与えられたクロージャを使って、このシーケンスの要素それらを結合する結果を返します。
func map<T>(((key: Key, value: Value)) -> T) -> [T]
Returns an array containing the results of mapping the given closure over the sequence’s elements. 与えられたクロージャをシーケンスのもつ要素全体にわたってマップする結果を含んでいる配列を返します。
func compactMap<ElementOfResult>(((key: Key, value: Value)) -> ElementOfResult?) -> [ElementOfResult]
Returns an array containing the non-nil results of calling the given transformation with each element of this sequence. 指定された変換をこのシーケンスの各要素で呼び出す結果で非-nilのものを含んでいる配列を返します。
func compactMapValues<T>((Value) -> T?) -> Dictionary<Key, T>
Returns a new dictionary containing only the key-value pairs that have non-nil values as the result of transformation by the given closure. 与えられたクロージャによる変換の結果として非nilを持つキー値ペアだけを含んでいる新しい辞書を返します。
func flatMap<ElementOfResult>(((key: Key, value: Value)) -> ElementOfResult?) -> [ElementOfResult]Deprecated 非推奨
func sorted(by: ((key: Key, value: Value), (key: Key, value: Value)) -> Bool) -> [(key: Key, value: Value)]
Returns the elements of the sequence, sorted using the given predicate as the comparison between elements. 与えられた述部を要素間の比較として使ってソートされた、シーケンスの要素を返します。
func shuffled() -> [(key: Key, value: Value)]
Returns the elements of the sequence, shuffled. 入れ替えた、シーケンスの要素を返します。
func shuffled<T>(using: inout T) -> [(key: Key, value: Value)]
Returns the elements of the sequence, shuffled using the given generator as a source for randomness. シーケンスの要素を返します、与えられた生成子を無作為さの出典として使って混ぜ合わされます。