Contents

ensureCapacity

Ensures the array has enough space to store the requested number of objects.

Declaration

virtual unsigned int ensureCapacity(
 unsigned intnewCapacity);

Parameters

  • newCapacity:

    The total number of objects the array should be able to store.

Return Value

The new capacity of the array, which may be different from the number requested (if smaller, reallocation of storage failed).

Overview

This function immediately resizes the array, if necessary, to accommodate at least newCapacity objects. If newCapacity is not greater than the current capacity, or if an allocation error occurs, the original capacity is returned.

There is no way to reduce the capacity of an OSArray.

See Also

Miscellaneous