Instance Method

firstIndex(of:)

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

Declaration

func firstIndex(of element: UInt8) -> Int?

Parameters

element

An element to search for in the collection.

Return Value

The first index where element is found. If element is not found in the collection, returns nil.

Discussion

After using firstIndex(of:) to find the position of a particular element in a collection, you can use it to access the element by subscripting. This example shows how you can modify one of the names in an array of students.

var students = ["Ben", "Ivy", "Jordell", "Maxime"]
if let i = students.firstIndex(of: "Maxime") {
    students[i] = "Max"
}
print(students)
// Prints "["Ben", "Ivy", "Jordell", "Max"]"

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

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software