A predicate that returns true
if its first argument should be ordered before its second argument; otherwise, false
.
ある述部、それはそれの最初の引数がそれの2番目の引数の前に並べられるべきならばtrue
を返します;そうでなければ、false
。
sorted(by:)
Availability 有効性
- iOS 15.0+
- iPadOS 15.0+
- macOS 12.0+
- Mac Catalyst 15.0+
- tvOS 15.0+
- watchOS 8.0+
- Xcode 13.0+
Technology
- Foundation ファウンデーション
Declaration 宣言
Parameters パラメータ
areInIncreasingOrder
Return Value 戻り値
A sorted array of the sequence’s elements. このシーケンス要素のソート済み配列。
Discussion 議論
When you want to sort a sequence of elements that don’t conform to the Comparable
protocol, pass a predicate to this method that returns true
when the first element should be ordered before the second. The elements of the resulting array are ordered according to the given predicate.
あなたがComparable
プロトコルに準拠しない要素からなるシーケンスをソートしたい場合、最初の要素が2番目の前に並べられるべき場合はtrue
を返す述部をこのメソッドに渡してください。結果の配列の要素は、与えられた述部にしたがって並べられます。
In the following example, the predicate provides an ordering for an array of a custom HTTPResponse
type. The predicate orders errors before successes and sorts the error responses by their error code.
以下の例では、その述部はあつらえのHTTPResponse
型の配列に対してある順序付けを提供します。この述部はエラーを成功の前に並べて、そしてそれらエラー応答をそのエラーコードによってソートします。
You also use this method to sort elements that conform to the Comparable
protocol in descending order. To sort your sequence in descending order, pass the greater-than operator (>
) as the are
parameter.
あなたはまた、このメソッドを使ってComparable
プロトコルに準拠する要素を降順でソートすることができます。あなたのシーケンスを降順にソートするには、より大きい演算子(>
)をare
パラメータとして渡してください。
Calling the related sorted()
method is equivalent to calling this method and passing the less-than operator (<
) as the predicate.
関連したsorted()
メソッドを呼び出すことは、このメソッドを呼び出して、より小さい演算子(<
)を述部として渡すことと等しいです。
The predicate must be a strict weak ordering over the elements. That is, for any elements a
, b
, and c
, the following conditions must hold:
述部は、それら要素に対して厳密弱順序でなければなりません。すなわち、何らかの要素a
、b
、そしてc
に対して、以下の条件が保持されなければなりません:
are
is alwaysIn Increasing Order(a, a) false
. (Irreflexivity)are
は常にIn Increasing Order(a, a) false
である。(非反射)If
are
andIn Increasing Order(a, b) are
are bothIn Increasing Order(b, c) true
, thenare
is alsoIn Increasing Order(a, c) true
. (Transitive comparability)are
とIn Increasing Order(a, b) are
が両方ともIn Increasing Order(b, c) true
ならば、そのときare
もまたIn Increasing Order(a, c) true
である。(推移的比較性)Two elements are incomparable if neither is ordered before the other according to the predicate. If
a
andb
are incomparable, andb
andc
are incomparable, thena
andc
are also incomparable. (Transitive incomparability) 2つの要素は、述部によるとどちらもが他の前に並べられるならば比較できない。a
とb
が比較できないならば、そしてb
とc
が比較できないならば、そのときa
とc
もまた比較できない。(推移的比較不能性)
The sorting algorithm is not guaranteed to be stable. A stable sort preserves the relative order of elements for which are
does not establish an order.
ソートアルゴリズムは、安定であることを保証されません。安定ソートは、それに対してare
が順序を確立しない要素それらの相対順序を保全します。
Complexity: O(n log n), where n is the length of the sequence. 計算量:O(n log n)、ここでnはシーケンスの長さです。