CFArrayInsertValueAtIndex |
||||
Header: | CFArray.h | Carbon status: | Supported | |
Adds the value to the array giving it the given index.
void CFArrayInsertValueAtIndex ( CFMutableArrayRef theArray, CFIndex idx, const void *value );
The array to which the value is to be added. If this parameter is not a valid mutable CFArray, the behavior is undefined. If the array is a fixed-capacity array and it is full before this operation, the behavior is undefined.
The index to which to add the new value. If the index is outside the index space of the array (0 to N inclusive, where N is the count of the array before the operation), the behavior is undefined. If the index is the same as N, this function has the same effect as CFArrayAppendValue().
The value to add to the array. The value is retained by the array using the retain callback provided when the array was created. If the value is not of the sort expected by the retain callback, the behavior is undefined. The value is assigned to the given index, and all values with equal and larger indices have their indexes increased by one.
Supported in Carbon. Available in Carbon 1.0.2 and later.
© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)