Instance Method

firstIndex(where:)

Returns the first index in which an element of the collection satisfies the given predicate.

Declaration

func firstIndex(where predicate: (Element) throws -> Bool) rethrows -> Int?

Parameters

predicate

A closure that takes an element as its argument and returns a Boolean value that indicates whether the passed element represents a match.

Return Value

The index of the first element for which predicate returns true. If no elements in the collection satisfy the given predicate, returns nil.

Discussion

You can use the predicate to find an element of a type that doesn’t conform to the Equatable protocol or to find an element that matches particular criteria. Here’s an example that finds a student name that begins with the letter “A”:

let students = ["Kofi", "Abena", "Peter", "Kweku", "Akosua"]
if let i = students.firstIndex(where: { $0.hasPrefix("A") }) {
    print("\(students[i]) starts with 'A'!")
}
// Prints "Abena starts with 'A'!"

Complexity: O(n), where n is the length of the collection.

See Also

Finding Elements

func contains(Element) -> Bool

Returns a Boolean value indicating whether the sequence contains the given element.

Available when Element conforms to Equatable.
func contains(where: (Element) -> Bool) -> Bool

Returns a Boolean value indicating whether the sequence contains an element that satisfies the given predicate.

func allSatisfy((Element) -> Bool) -> Bool

Returns a Boolean value indicating whether every element of a sequence satisfies a given predicate.

func first(where: (Element) -> Bool) -> Element?

Returns the first element of the sequence that satisfies the given predicate.

func firstIndex(of: Element) -> Int?

Returns the first index where the specified value appears in the collection.

Available when Element conforms to Equatable.
func index(of: Element) -> Int?

Returns the first index where the specified value appears in the collection.

Available when Element conforms to Equatable.
Deprecated
func last(where: (Element) -> Bool) -> Element?

Returns the last element of the sequence that satisfies the given predicate.

func lastIndex(of: Element) -> Int?

Returns the last index where the specified value appears in the collection.

Available when Element conforms to Equatable.
func lastIndex(where: (Element) -> Bool) -> Int?

Returns the index of the last element in the collection that matches the given predicate.

func min() -> Element?

Returns the minimum element in the sequence.

Available when Element conforms to Comparable.
func min(by: (Element, Element) -> Bool) -> Element?

Returns the minimum element in the sequence, using the given predicate as the comparison between elements.

func max() -> Element?

Returns the maximum element in the sequence.

Available when Element conforms to Comparable.
func max(by: (Element, Element) -> Bool) -> Element?

Returns the maximum element in the sequence, using the given predicate as the comparison between elements.