XCode 9.4 日本語化計画：Swift 標準ライブラリ: EnumeratedSequence

文書   >   Swift   >   Swift 標準ライブラリ   >   Collections   >   Supporting Types   >   EnumeratedSequence   >   max(by:)

インスタンスメソッド

max(by:)

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

宣言

@warn_unqualified_access func max(by areInIncreasingOrder: ((offset: Int,
	 element: Base.Element), (offset: Int, element: Base.Element)) throws ->
	 Bool) rethrows -> (offset: Int, element: Base.Element)?

パラメータ

戻り値

シーケンスが空でない場合、シーケンスの最大要素。それ以外の場合は、nil を返します。

議論

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

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


• areInIncreasingOrder(a、b) と areInIncreasingOrder(b、c) が両方とも true の場合、areInIncreasingOrder(a、c) も true です。(推移比較可能性)


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

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

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

複雑さ：O(n)、ここで n はシーケンスの長さです。