Instance Property

indices

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

Declaration

var indices: DefaultBidirectionalIndices<String> { get }

Discussion

A collection’s indices property can hold a strong reference to the collection itself, causing the collection to be non-uniquely referenced. If you mutate the collection while iterating over its indices, a strong reference can cause an unexpected copy of the collection. To avoid the unexpected copy, use the index(after:) method starting with startIndex to produce indices instead.

var c = MyFancyCollection([10, 20, 30, 40, 50])
var i = c.startIndex
while i != c.endIndex {
    c[i] /= 5
    i = c.index(after: i)
}
// c == MyFancyCollection([2, 4, 6, 8, 10])

See Also

Manipulating Indices

var startIndex: String.Index

The position of the first character in a nonempty string.

var endIndex: String.Index

A string’s “past the end” position—that is, the position one greater than the last valid subscript argument.

func index(after: String.Index)

Returns the position immediately after the given index.

func index(String.Index, offsetBy: String.IndexDistance)

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

func index(String.Index, offsetBy: String.IndexDistance, limitedBy: String.Index)

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

func distance(from: String.Index, to: String.Index)

Returns the distance between two indices.