インスタンスメソッド
max(by:)
与えられた述語 (predicate) を要素間の比較として使って、シーケンス内の最大の要素を返します。
宣言
rethrows -> Element?
パラメータ
| areInIncreasingOrder | 最初の引数を 2 番目の引数の前に並べるべき場合に true を返す述語 (predicate)。そうでなければ、false。 |
戻り値
シーケンスが空でない場合、シーケンスの最大の要素。そうでない場合、nil。
議論
述語は、要素に対して 厳密に弱い順序付け でなければなりません。つまり、任意の要素 a、b、 および c について、以下の条件が成り立たなければなりません。
- areInIncreasingOrder(a, a) は常に false です。(非再帰性)
- areInIncreasingOrder(a, b) と areInIncreasingOrder(b, c) が共に true の場合、areInIncreasingOrder(a, c) もまた true です。(推移比較可能性)
- 2 つの要素が、どちらも述語 (predicate) に従って他の要素の前に順序付けされていない場合、比較不可能 です。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 はシーケンスの長さです。
以下も見よ
要素の検索
func contains(Element) -> Bool
シーケンスに与えられた要素が含まれているかどうかを示すブール値を返します。
Element が Equatable に準拠している場合に利用可能です。
func contains(where: (Element) -> Bool) -> Bool
指定された述語 (predicate) を満たす要素がシーケンスに含まれているかどうかを示すブール値を返します。
func allSatisfy((Element) -> Bool) -> Bool
シーケンスのすべての要素が与えられた述語 (predicate) を満たすかどうかを示すブール値を返します。
func first(where: (Element) -> Bool) -> Element?
与えられた述語を満たすシーケンスの最初の要素を返します。
func firstIndex(of: Element) -> Int?
指定された値がコレクション内で現れる最初のインデックスを返します。
Element が Equatable に準拠している場合に利用可能です。
func index(of: Element) -> Int?
指定された値がコレクション内で現れる最初のインデックスを返します。
Element が Equatable に準拠している場合に利用可能です。
廃止
func firstIndex(where: (Element) -> Bool) -> Int?
コレクションの要素が与えられた述語 (predicate) を満たす最初のインデックスを返します。
func last(where: (Element) -> Bool) -> Element?
与えられた述語 (predicate) を満たすシーケンスの最後の要素を返します。
func lastIndex(of: Element) -> Int?
指定した値がコレクション内で現れる最後のインデックスを返します。
Element が Comparable に準拠している場合に利用可能です。
func lastIndex(where: (Element) -> Bool) -> Int?
与えられた述語 (predicate) に一致するコレクション内の最後の要素のインデックスを返します。
シーケンス内の最小の要素を返します。
Element が Comparable に準拠している場合に利用可能です。
func min(by: (Element, Element) -> Bool) -> Element?
与えられた述語 (predicate) を要素間の比較として使って、シーケンス内の最小の要素を返します。
シーケンス内の最大の要素を返します。
Element が Comparable に準拠している場合に利用可能です。
トップへ
トップへ
トップへ
トップへ
トップへ