Instance Method

reserveCapacity(_:)

Prepares the collection to store the specified number of elements, when doing so is appropriate for the underlying type.

Required. Default implementation provided.

Declaration

mutating func reserveCapacity(_ n: Int)

Parameters

n

The requested number of elements to store.

Discussion

If you are adding a known number of elements to a collection, use this method to avoid multiple reallocations. A type that conforms to RangeReplaceableCollection can choose how to respond when this method is called. Depending on the type, it may make sense to allocate more or less storage than requested, or to take no action at all.

Default Implementations

RangeReplaceableCollection Implementations

func reserveCapacity(Int)

Prepares the collection to store the specified number of elements, when doing so is appropriate for the underlying type.