文書   >   Swift 標準ライブラリ   >   Collections   >   Supporting Types   >   AnySequence   >   reduce(into:_:)
汎用インスタンスメソッド
reduce(into:_:)
指定されたクロージャを使用してシーケンスの要素を結合した結果を返します。
宣言
func reduce<Result>(into initialResult: Result, _ updateAccumulatingResult: (inout Result, Element) throws -> ()) rethrows -> Result
パラメータ
initialResult | 初期累積値として使用すべき値。 |
updateAccumulatingResult | シーケンスの要素で累積値を更新するクロージャ。 |
戻り値
最終的な累積値。シーケンスに要素がない場合、結果は 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:_:) が呼び出されると、以下の手順が実行されます。
- updateAccumulatingResult クロージャは、最初の累積値 (この場合 [:] ) と letters の最初の文字で呼び出され、キー "a" に 1 を設定して累積値を変更します。
- クロージャは、更新された累積値とシーケンスの各要素で繰り返し呼び出されます。
- シーケンスが使い尽くされると、累積値が呼び出し側に返されます。
シーケンスに要素がない場合、updateAccumulatingResult は決して実行されず、initialResult は reduce(into:_:) の呼び出しの結果になります。