CFDictionaryReplaceValue

Header: CFDictionary.h Carbon status: Supported

Replaces the value of the key in the dictionary.

void CFDictionaryReplaceValue (
    CFMutableDictionaryRef dict, 
    const void *key, 
    const void *value
);
Parameter descriptions
dict

The dictionary to which the value is to be replaced. If this parameter is not a valid mutable CFDictionary, the behavior is undefined.

key

The key of the value to replace in the dictionary. If a key which matches this key is present in the dictionary, the value is changed to the given value, otherwise this function does nothing ("replace if present").

value

The value to replace into the dictionary. The value is retained by the dictionary using the retain callback provided when the dictionary was created, and the previous value is released. If the value is not of the sort expected by the retain or release callbacks, the behavior is undefined.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later.


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