Returns an index that is the specified distance from the given index.
Required. Default implementation provided.
- Xcode 10.0+
- Swift Standard Library
A valid index of the collection.
The distance to offset
distancemust not be negative unless the collection conforms to the
An index offset by
distance from the index
distance is positive, this is the same value as the result of
distance calls to
distance is negative, this is the same value as the result of
abs(distance) calls to
The following example obtains an index advanced four positions from a string’s starting index and then prints the character at that position.
The value passed as
distance must not offset
i beyond the bounds of the collection.
Complexity: O(1) if the collection conforms to
Random; otherwise, O(k), where k is the absolute value of