Contents

initWithArray

Initializes a new OSArray populated with the contents of another array.

Declaration

virtual bool initWithArray( 
 const OSArray *anArray, 
 unsigned int capacity = 0);

Parameters

  • anArray:

    The array whose contents will be placed in the new instance.

  • capacity:

    The initial storage capacity of the array object. If 0, the capacity is set to the number of objects in array; otherwise capacity must be greater than or equal to the number of objects in array.

Return Value

true on success, false on failure.

Overview

Not for general use. Use the static instance creation method withArray instead.

array must be non-NULL. If capacity is nonzero, it must be greater than or equal to count. The new array will grow as needed to accommodate more objects (unlikeCFMutableArray, for which the initial capacity is a hard limit).

The objects in array are retained for storage in the new OSArray, not copied.

See Also

Miscellaneous