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 );
The dictionary to which the value is to be replaced. If this parameter is not a valid mutable CFDictionary, the behavior is undefined.
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").
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.
Supported in Carbon. Available in Carbon 1.0.2 and later.
© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)