Instance Method

formIndex(_:offsetBy:)

Offsets the given index by the specified distance.

Declaration

func formIndex(_ i: inout Int, offsetBy distance: Int)

Parameters

i

A valid index of the collection.

distance

The distance to offset i. distance must not be negative unless the collection conforms to the BidirectionalCollection protocol.

Discussion

The value passed as distance must not offset i beyond the bounds of the collection.

Complexity: O(1) if the collection conforms to RandomAccessCollection; otherwise, O(k), where k is the absolute value of distance.

See Also

Manipulating Indices

func distance(from: Int, to: Int) -> Int

Returns the distance between two indices.

var indices: DefaultIndices<Entity.ChildCollection>

The indices that are valid for subscripting the collection, in ascending order.

func firstIndex(of: Entity) -> Int?

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

func firstIndex(where: (Entity) -> Bool) -> Int?

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

func formIndex(inout Int, offsetBy: Int, limitedBy: Int) -> Bool

Offsets the given index by the specified distance, or so that it equals the given limiting index.

func formIndex(after: inout Int)

Replaces the given index with its successor.

func index(Int, offsetBy: Int) -> Int

Returns an index that is the specified distance from the given index.

func index(Int, offsetBy: Int, limitedBy: Int) -> Int?

Returns an index that is the specified distance from the given index, unless that distance is beyond a given limiting index.

func index(of: Entity) -> Int?

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

Deprecated