XCode 10.3 日本語化計画：Swift 標準ライブラリ UnsafeBufferPointer

文書   >   Swift   >   Swift 標準ライブラリ  >     手動でメモリ管理   >   UnsafeBufferPointer   >   reduce(_:_:)

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

reduce(_:_:)

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

宣言

パラメータ

戻り値

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

議論

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

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

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

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

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


2. クロージャは、前回の呼び出しの戻り値とシーケンスの各要素で繰り返し呼び出されます。


3. シーケンスが使い果たされると、クロージャから返された最後の値が呼び出し元に返されます。

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

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