Instance Method インスタンスメソッド

min(by:)

Returns the minimum element in the asynchronous sequence, using the given predicate as the comparison between elements. 非同期シーケンスの中の最小の要素を返します、与えられた述部を要素間の比較として使います。

Declaration 宣言 

@warn_unqualified_access func min(by areInIncreasingOrder: (Character, Character) async throws -> Bool) async rethrows -> Character?

Parameters パラメータ

areInIncreasingOrder

A predicate that returns true if its first argument should be ordered before its second argument; otherwise, false. ある述部、それはそれの最初の引数がそれの２番目の引数の前に並べられるべきならばtrueを返します；そうでなければ、false。

Return Value 戻り値

The sequence’s minimum element, according to areInIncreasingOrder. If the sequence has no elements, returns nil. シーケンスの最小の要素、areInIncreasingOrderによる。シーケンスが要素を持たないならば、nilを返します。

Discussion 議論

Use this method when the asynchronous sequence’s values don’t conform to Comparable, or when you want to apply a custom ordering to the sequence. このメソッドを、非同期シーケンスのもつ値それらがComparableに準拠しない時に、またはあなたがあるあつらえの順序付けをそのシーケンスに適用したい時に使ってください。

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に対して、以下の条件が保持されなければなりません：

  • areInIncreasingOrder(a, a) is always false. (Irreflexivity) areInIncreasingOrder(a, a)は常にfalseである。（非反射）

  • If areInIncreasingOrder(a, b) and areInIncreasingOrder(b, c) are both true, then areInIncreasingOrder(a, c) is also true. (Transitive comparability) areInIncreasingOrder(a, b)とareInIncreasingOrder(b, c)が両方ともtrueならば、そのときareInIncreasingOrder(a, c)もまたtrueである。（推移的比較性）

  • Two elements are incomparable if neither is ordered before the other according to the predicate. If a and b are incomparable, and b and c are incomparable, then a and c are also incomparable. (Transitive incomparability) ２つの要素は、述部によるとどちらもが他の前に並べられるならば比較できない。aとbが比較できないならば、そしてbとcが比較できないならば、そのときaとcもまた比較できない。（推移的比較不能性）

The following example uses an enumeration of playing cards ranks, Rank, which ranges from ace (low) to king (high). An asynchronous sequence called RankCounter produces all elements of the array. The predicate provided to the min(by:) method sorts ranks based on their rawValue: 以下の例は、トランプのランクそれらからなるある列挙、Rankを使います、それはace（低）からking（高）までに及びます。RankCounterと呼ばれる非同期シーケンスは、その配列のすべての要素を取り出します。min(by:)メソッドに提供された述部は、ランクそれらをそれらのrawValueに基づいて並べ換えます： 


enum Rank: Int {
    case ace = 1, two, three, four, five, six, seven, eight, nine, ten, jack, queen, king
}


let min = await RankCounter()
    .min { $0.rawValue < $1.rawValue }
print(min ?? "none")
// Prints: ace

See Also 参照

Finding Elements 要素を見つける

func contains(Character) -> Bool
Returns a Boolean value that indicates whether the asynchronous sequence contains the given element. あるブール値を返します、それは非同期シーケンスがこの与えられた要素を含むかどうかを指し示します。
func contains(where: (Character) -> Bool) -> Bool
Returns a Boolean value that indicates whether the asynchronous sequence contains an element that satisfies the given predicate. あるブール値を返します、それは非同期シーケンスがこの与えられた述部を満足させる要素を含むかどうかを指し示します。
func allSatisfy((Character) -> Bool) -> Bool
Returns a Boolean value that indicates whether all elements produced by the asynchronous sequence satisfies the given predicate. あるブール値を返します、それは非同期シーケンスによって生み出される全ての要素がこの与えられた述部を満足させるかどうかを指し示します。
func first(where: (Character) -> Bool) -> Character?
Returns the first element of the sequence that satisfies the given predicate. 与えられた述部を満たすこのシーケンスの最初の要素を返します。
func min() -> Character?
Returns the minimum element in an asynchronous sequence of comparable elements. 比較可能要素それらからなるある非同期シーケンスの中の最小の要素を返します。
func max() -> Character?
Returns the maximum element in an asynchronous sequence of comparable elements. 比較可能要素それらからなるある非同期シーケンスの中の最大の要素を返します。
func max(by: (Character, Character) -> Bool) -> Character?
Returns the maximum element in the asynchronous sequence, using the given predicate as the comparison between elements. 非同期シーケンスの中の最大の要素を返します、与えられた述部を要素間の比較として使います。