XCode 10.2 日本語化計画：Foundation: Set

文書   >   Foundation   >   Collections   >   Set   >   reduce(into:_:)

汎用インスタンスメソッド

reduce(into:_:)

与えられたクロージャを使用してシーケンスの要素を組み合わせた結果を返します。

宣言

パラメータ

戻り値

最終的な累積値。シーケンスに要素がない場合、結果は initialResult です。

議論

シーケンス全体の要素から単一の値を生成するには、reduce(into:_:) メソッドを使用します。たとえば、整数の配列に対してこのメソッドを使用して、隣接する等しいエントリをフィルタリングしたり頻度を数えたりできます。

このメソッドは、結果が書いた時コピーする型 (Array や Dictionary など) の場合、効率のため reduce(_:_:) よりも好まれます。

updateAccumulatingResult クロージャは、initialResult およびシーケンスの各要素に初期化された可変累積値を使用して順次呼び出されます。この例では、文字列の文字頻度の辞書を作成する方法を示します。

let letters = "abracadabra"
let letterCount = letters.reduce(into: [:]) { counts, letter in
    counts[letter, default: 0] += 1
}
// letterCount == ["a": 5, "b": 2, "r": 2, "c": 1, "d": 1]

letters.reduce(into:_:) が呼び出されると、以下のステップが発生します。

1. updateAccumulatingResult クロージャは、初期累積値 (この場合は[:]) と letters の最初の文字を使用して呼び出され、キー "a" に 1 を設定して累積値を変更します。


2. クロージャは、更新された累積値とシーケンスの各要素を使用して繰り返し呼び出されます。


3. シーケンスが使い果たされると、累積値が呼び出し側に返されます。

シーケンスに要素がない場合、updateAccumulatingResult は決して実行されず、initialResult が reduce(into:_:) の呼び出しの結果になります。

複雑さ:O(n)、ここで n はシーケンスの長さです。

以下も見よ

Set の変形

func map<T>((Element) -> T) -> [T]




与えられたクロージャをシーケンスの要素にマッピングした結果を含む配列を返します。




func compactMap<ElementOfResult>((Element) -> ElementOfResult?) -> [ElementOfResult]




このシーケンスの各要素を使用して、与えられた変換を呼び出した結果の nil 以外の結果を含む配列を返します。




func flatMap<SegmentOfResult>((Element) -> SegmentOfResult) -> [SegmentOfResult.Element]




このシーケンスの各要素を使用して、与えられた変換を呼び出した結果を連結したものを含む配列を返します。




func flatMap<ElementOfResult>((Element) -> ElementOfResult?) -> [ElementOfResult]
  廃止  




func reduce<Result>(Result, (Result, Element) -> Result) -> Result




与えられたクロージャを使用してシーケンスの要素を組み合わせた結果を返します。




func sorted() -> [Element]




並べ替えられたシーケンスの要素を返します。
Element が Comparable に準拠している場合利用可能です。




func sorted(by: (Element, Element) -> Bool) -> [Element]




与えられた述語 (predicate) を要素間の比較として使用して、並べ替えられたシーケンスの要素を返します。




func shuffled() -> [Element]




シーケンスの要素をシャッフルして返します。




func shuffled<T>(using: inout T) -> [Element]




乱数の発生源として与えられた発生器を使用してシャッフルされた、シーケンスの要素を返します。




var lazy: LazySequence<Set<Element>>




このシーケンスと同じ要素を含むが、map や filter などの一部の操作が遅延的に実装されているシーケンス。