文書 > Swift > Swift 標準ライブラリ > Collections > Range > reduce(into:_:)
汎用インスタンスメソッド
reduce(into:_:)
与えられたクロージャを使用してシーケンスの要素を結合した結果を返します。
宣言
func reduce<Result>(into initialResult: Result, _ updateAccumulatingResult: (inout Result, Bound) throws -> ()) rethrows -> Result
Bound が Strideable に準拠し、Bound.Stride が SignedInteger に準拠する場合に使用可能です。
パラメータ
| initialResult | 初期累積値として使用する値。 |
| updateAccumulatingResult | シーケンスの要素で累積値を更新するクロージャ。 |
戻り値
最終的な累積値。シーケンスに要素がない場合、結果は initialResult になります。
議論
reduce(into:_:) メソッドを使用して、シーケンス全体の要素から単一の値を生成します。たとえば、整数の配列に対してこのメソッドを使用して、隣接する等しいエントリーまたは count の頻度をフィルターすることができます。
このメソッドは、結果がコピーオンライト型 (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:_:) の呼び出しの結果になります。
複雑さ：O(n)、ここで n はシーケンスの長さです。
以下も見よ
Range の要素を変換
func map<T>((Bound) -> T) -> [T]
与えられたクロージャをシーケンスの要素にマッピングした結果を含む配列を返します。
Bound が Strideable に準拠し、Bound.Stride が SignedInteger に準拠する場合に使用可能です。
func map<T>((Bound) -> T) -> [T]
指定されたクロージャをシーケンスの要素にマッピングした結果を含む配列を返します。
Bound が Strideable に準拠し、Bound.Stride が SignedInteger に準拠する場合に使用可能です。
func compactMap<ElementOfResult>((Bound) -> ElementOfResult?) -> [ElementOfResult]
このシーケンスの各要素で、与えられた変換を呼び出した結果が nil でない結果を含む配列を返します。
Bound が Strideable に準拠し、Bound.Stride が SignedInteger に準拠する場合に使用可能です。
func flatMap((Bound) -> String?) -> [String]
Bound が Strideable に準拠し、Bound.Stride が SignedInteger に準拠する場合に使用可能です。
廃止
func reduce<Result>(Result, (Result, Bound) -> Result) -> Result
与えられたクロージャを使用してシーケンスの要素を結合した結果を返します。
Bound が Strideable に準拠し、Bound.Stride が SignedInteger に準拠する場合に使用可能です。
var lazy: LazyCollection<Range<Bound>>
このコレクションへのビューで、map や filter などの通常の操作の遅延した実装を提供します。
var lazy: LazySequence<Range<Bound>>
このシーケンスと同じ要素を含むシーケンスですが、map や filter などの一部の操作は遅延して実装されています。
Bound が Strideable に準拠し、Bound.Stride が SignedInteger に準拠する場合に使用可能です。