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 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 宣言
func sorted(by areInIncreasingOrder: (String
.UnicodeScalarView
.Element
, String
.UnicodeScalarView
.Element
) throws -> Bool
) rethrows -> [String
.UnicodeScalarView
.Element
]
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はシーケンスの長さです。