A predicate used to partition the collection. All elements satisfying this predicate are ordered after all elements not satisfying it. コレクションに仕切りをするのに使われる述部。この述部を満たす全ての要素は、それを満たさない全ての要素の後に並べられます。
Instance Method
インスタンスメソッド
partition(by:)
Reorders the elements of the collection such that all the elements that match the given predicate are after all the elements that don’t match.
コレクションの要素を再配列します、例えば、与えられた述部にマッチする要素すべてが、合致しない要素すべての後になるなど。
Availability
- iOS 8.0+
- iPadOS 8.0+
- macOS 10.10+
- Mac Catalyst 13.0+
- tvOS 9.0+
- watchOS 2.0+
- Xcode 10.0+
Technology
- Swift Standard Library Swift標準ライブラリ
Declaration 宣言
mutating func partition(by belongsInSecondPartition: (Base.Element) throws -> Bool) rethrows -> Base.IndexAvailable when
Base conforms to MutableCollection .
BaseがMutableCollection に準拠する時に利用可能です。
Parameters パラメータ
belongsInSecondPartition
Return Value 戻り値
The index of the first element in the reordered collection that matches belongs. If no elements in the collection match belongs, the returned index is equal to the collection’s end.
並べ直されたコレクションの中の最初の要素のインデックス、それはbelongsに合致します。コレクションの中の要素が１つもbelongsに一致しないならば、返されるインデックスはコレクションのendと等しいです。
Discussion 解説
After partitioning a collection, there is a pivot index p where no element before p satisfies the belongs predicate and every element at or after p satisfies belongs.
コレクションを仕切った後、あるピボットインデックスpがあります、そこでpの前の要素は１つもbelongs述部を満たさず、そしてpでのまたは後のあらゆる要素はbelongsを満たします。
This operation isn’t guaranteed to be stable, so the relative ordering of elements within the partitions might change.
In the following example, an array of numbers is partitioned by a predicate that matches elements greater than 30. 次の例において、数からなる配列は、30より大きな要素に合致するという述部によって仕切られます。
var numbers = [30, 40, 20, 30, 30, 60, 10]
let p = numbers.partition(by: { $0 > 30 })
// p == 5
// numbers == [30, 10, 20, 30, 30, 60, 40]The numbers array is now arranged in two partitions. The first partition, numbers[..<p], is made up of the elements that are not greater than 30. The second partition, numbers[p...], is made up of the elements that are greater than 30.
numbers配列は今や２つの区分に整頓されます。最初の区画、numbers[..<p]は、30より大きくない要素から構成されます。２番目の区画、numbers[p...]は、30より大きなものである要素から構成されます。
let first = numbers[..<p]
// first == [30, 10, 20, 30, 30]
let second = numbers[p...]
// second == [60, 40]Note that the order of elements in both partitions changed. That is, 40 appears before 60 in the original collection, but, after calling partition(by:), 60 appears before 40.
Complexity: O(n), where n is the length of the collection. 計算量：O(n)、ここでnはコレクションの長さです。