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

first(where:)

Returns the first element of the sequence that satisfies the given predicate. 与えられた述部を満たすこのシーケンスの最初の要素を返します。

Declaration 宣言 

func first(where predicate: ((key: Key, value: Value)) throws -> Bool) rethrows -> (key: Key, value: Value)?

Parameters パラメータ

predicate

A closure that takes an element of the sequence as its argument and returns a Boolean value indicating whether the element is a match. あるクロージャ、それはシーケンスの１つの要素をそれの引数として取り、その要素が合致するものかどうかを指し示しているブール値を返します。

Return Value 戻り値

The first element of the sequence that satisfies predicate, or nil if there is no element that satisfies predicate. predicate満たすシーケンスの最初の要素、またはpredicateを満たす要素が無いならばnil。

Discussion 解説

The following example uses the first(where:) method to find the first negative number in an array of integers: 以下の例は、first(where:)メソッドを使って、整数の配列において最初の負数を見つけます： 


let numbers = [3, 7, 4, -2, 9, -6, 10, 1]
if let firstNegative = numbers.first(where: { $0 < 0 }) {
    print("The first negative number is \(firstNegative).")
}
// Prints "The first negative number is -2."

Complexity: O(n), where n is the length of the sequence. 計算量：O(n)、ここでnはシーケンスの長さです。

See Also 参照

Finding Elements 要素を見つける

func contains(where: ((key: Key, value: Value)) -> Bool) -> Bool
Returns a Boolean value indicating whether the sequence contains an element that satisfies the given predicate. 指定された述部を満足させるある要素をシーケンスが含むかどうかを指し示すブール値を返します。
func allSatisfy(((key: Key, value: Value)) -> Bool) -> Bool
Returns a Boolean value indicating whether every element of a sequence satisfies a given predicate. シーケンスのすべての要素がある与えられた述部を満たすかどうかを指し示すブール値を返します。
func firstIndex(where: ((key: Key, value: Value)) -> Bool) -> Index?
Returns the first index in which an element of the collection satisfies the given predicate. 最初のインデックスで、それにおけるコレクションの要素が与えられた述部を満足させるものを返します。
func min(by: ((key: Key, value: Value), (key: Key, value: Value)) -> Bool) -> (key: Key, value: Value)?
Returns the minimum element in the sequence, using the given predicate as the comparison between elements. シーケンスの中の最小の要素を返します、与えられた述部を要素間の比較として使います。
func max(by: ((key: Key, value: Value), (key: Key, value: Value)) -> Bool) -> (key: Key, value: Value)?
Returns the maximum element in the sequence, using the given predicate as the comparison between elements. シーケンスの中の最大の要素を返します、与えられた述部を要素間の比較として使います。