Function

CFDictionaryGetCountOfKey

Returns the number of times a key occurs in a dictionary.

Declaration

CFIndex CFDictionaryGetCountOfKey(CFDictionaryRef theDict, const void *key);

Parameters

theDict

The dictionary to examine.

key

The key for which to find matches in theDict. The key hash and equal callbacks provided when the dictionary was created are used to compare. If the hash callback was NULL, the key is treated as a pointer and converted to an integer. If the equal callback was NULL, pointer equality (in C, ==) is used. If key, or any of the keys in the dictionary, is not understood by the equal callback, the behavior is undefined.

Return Value

Returns 1 if a matching key is used by the dictionary, otherwise 0.

See Also

Examining a dictionary

CFDictionaryContainsKey

Returns a Boolean value that indicates whether a given key is in a dictionary.

CFDictionaryContainsValue

Returns a Boolean value that indicates whether a given value is in a dictionary.

CFDictionaryGetCount

Returns the number of key-value pairs in a dictionary.

CFDictionaryGetCountOfValue

Counts the number of times a given value occurs in the dictionary.

CFDictionaryGetKeysAndValues

Fills two buffers with the keys and values from a dictionary.

CFDictionaryGetValue

Returns the value associated with a given key.

CFDictionaryGetValueIfPresent

Returns a Boolean value that indicates whether a given value for a given key is in a dictionary, and returns that value indirectly if it exists.