CFArrayAppendValue

Header: CFArray.h Carbon status: Supported

Adds the value to the array giving it the new largest index.

void CFArrayAppendValue (
    CFMutableArrayRef theArray, 
    const void *value
);
Parameter descriptions
theArray

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.

value

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 index one larger than the previous largest index, and the count of the array is increased by one.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)