文書   >   Swift   >  String   >   Substring   >   reduce(_:_:)
汎用インスタンスメソッド
reduce(_:_:)
与えられたクロージャを使用してシーケンスの要素を組み合わせた結果を返します。
宣言
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) と数値の最初の要素と共に呼び出され、合計 1 を返します。
- 前の呼び出しの戻り値とシーケンスの各要素を使用して、クロージャが再び繰り返し呼び出されます。
- シーケンスが使い果たされると、クロージャから返された最後の値が呼び出し元に返されます。
シーケンスに要素がない場合、nextPartialResult は決して実行されず、initialResult が reduce(_:_:) の呼び出しの結果となります。
複雑さ: O(n)、ここで n はシーケンスの長さです。
トップへ(Swift 標準ライブラリ)
トップへ(Swift 標準ライブラリ)
トップへ(Swift 標準ライブラリ)
トップへ(Swift 標準ライブラリ)