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

reduce(_:_:)

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

func reduce<Result>(_ initialResult: Result, _ nextPartialResult: (Result,
	 Base.Element.Element) throws -> Result) rethrows -> Result

initialResult	初期累積値として使用する値。initialResult は、クロージャが最初に実行されるときに nextPartialResult に渡されます。
nextPartialResult	nextPartialResult クロージャの次の呼び出しで使用されるか、呼び出し元に返される、新しい累積値に累積値とシーケンスの要素を組み合わせたクロージャ。

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

reduce(_:_:) メソッドを使用して、シーケンス全体の要素から単一の値を生成します。たとえば、数値の配列でこのメソッドを使用して、その合計または積を見つけることができます。

nextPartialResult クロージャは、initialResult とシーケンスの各要素に初期化された累積値で順次呼び出されます。この例は、数値の配列の合計を見つける方法を示しています。


let numbers = [1, 2, 3, 4]
let numberSum = numbers.reduce(0, { x, y in
    x + y
})
// numberSum == 10

numbers.reduce(_:_:) が呼び出されると、以下の手順が起こります。

nextPartialResult クロージャは、initialResult と、この場合は 0 と、numbers の最初の要素で呼び出され、合計の１を返します。

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

複雑さ：O(n)、ここで n はコレクションの長さです。