XCode 11.3.1 日本語化計画：Swift 標準ライブラリ: KeyValuePairs

文書  >   Swift   >   Swift 標準ライブラリ   >   Collections   >   KeyValuePairs   >   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 はシーケンスの長さです。