インスタンスメソッド

min(by:)

与えられた述語 (predicate) を要素間の比較として使用して、シーケンス内の最小要素を返します。

宣言

@warn_unqualified_access func min(by areInIncreasingOrder: ((key: Key, value: Value), (key: Key, value: Value)) throws -> Bool) rethrows -> (key: Key, value: Value)?

パラメータ

areInIncreasingOrder

最初の引数を 2 番目の引数の前に並べるべき場合に true を返す述語 (predicate)。それ以外の場合は false。

戻り値

areInIncreasingOrder によるシーケンスの最小要素。シーケンスに要素がない場合、nil を返します。

議論

述語 (predicate) は、要素に対して 厳密に弱い順序 でなければなりません。つまり、任意の要素 a、b、および c について、以下の条件が満たされなければなりません。

areInIncreasingOrder(a, a) は常に false です。(非再帰性)

areInIncreasingOrder(a, b) と areInIncreasingOrder(b, c) が共に true の場合, areInIncreasingOrder(a, c) も又 true です。 (推移比較可能性)

2 つの要素がどちらも述語に従って他の要素より前に順序付けられていない場合、2 つの要素は 比較できません。a と b が比較できず、b と c が比較できない場合、a と c も比較できません。(推移比較不能性)

この例では、辞書で min(by:) メソッドを使用して、最小値を持つキー値のペアを見つける方法を示します。

let hues = ["Heliotrope": 296, "Coral": 16, "Aquamarine": 156]
let leastHue = hues.min { a, b in a.value < b.value }
print(leastHue)
// Prints "Optional(("Coral", 16))"