CFArrayGetCountOfValue

Header: CFArray.h Carbon status: Supported

Counts the number of times the given value occurs in the array.

CFIndex CFArrayGetCountOfValue (
    CFArrayRef theArray, 
    CFRange range, 
    const void *value
);
Parameter descriptions
theArray

The array to be searched. If this parameter is not a valid CFArray, the behavior is undefined.

range

The range within the array to search. If the range location or end point (defined by the location plus length minus 1) are outside the index space of the array (0 to N-1 inclusive, where N is the count of the array), the behavior is undefined. If the range length is negative, the behavior is undefined. The range may be empty (length 0).

value

The value for which to find matches in the array. The equal() callback provided when the array was created is used to compare. If the equal() callback was NULL, pointer equality (in C, ==) is used. If value, or any of the values in the array, are not understood by the equal() callback, the behavior is undefined.

function result

The number of times the given value occurs in the array, within the specified range.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later.


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