Instance Property

indices

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

Declaration

var indices: DefaultIndices<Dictionary<Key, Value>> { 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: Dictionary<Key, Value>.Index

The position of the first element in a nonempty dictionary.

var endIndex: Dictionary<Key, Value>.Index

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

func index(after: Dictionary<Key, Value>.Index) -> Dictionary<Key, Value>.Index

Returns the position immediately after the given index.

func formIndex(after: inout Dictionary<Key, Value>.Index)

Replaces the given index with its successor.

func index(Dictionary<Key, Value>.Index, offsetBy: Int) -> Dictionary<Key, Value>.Index

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

func formIndex(inout Dictionary<Key, Value>.Index, offsetBy: Int)

Offsets the given index by the specified distance.

func index(Dictionary<Key, Value>.Index, offsetBy: Int, limitedBy: Dictionary<Key, Value>.Index) -> Dictionary<Key, Value>.Index?

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

func formIndex(inout Dictionary<Key, Value>.Index, offsetBy: Int, limitedBy: Dictionary<Key, Value>.Index) -> Bool

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