CFDictionaryCreateMutableCopy |
||||
Header: | CFDictionary.h | Carbon status: | Supported | |
Creates a new mutable dictionary with the key-value pairs from the given dictionary.
CFMutableDictionaryRef CFDictionaryCreateMutableCopy ( CFAllocatorRef allocator, CFIndex capacity, CFDictionaryRef dict );
The CFAllocator which should be used to allocate memory for the dictionary and its storage for values. This parameter may be NULL in which case the current default CFAllocator is used. If this reference is not a valid CFAllocator, the behavior is undefined.
The maximum number of values that can be contained by the CFDictionary. The dictionary starts empty, and can grow to this number of values (and it can have less). If this parameter is 0, the dictionary's maximum capacity is unlimited (or rather, only limited by address space and available memory constraints). This parameter must be greater than or equal to the count of the dictionary which is to be copied, or the behavior is undefined. If this parameter is negative, the behavior is undefined.
The dictionary which is to be copied. The keys and values from the dictionary are copied as pointers into the new dictionary (that is, the values themselves are copied, not that which the values point to, if anything). However, the keys and values are also retained by the new dictionary using the retain function of the original dictionary. The count of the new dictionary will be the same as the given dictionary. The new dictionary uses the same callbacks as the dictionary to be copied. If this parameter is not a valid CFDictionary, the behavior is undefined.
A reference to the new mutable CFDictionary.
Supported in Carbon. Available in Carbon 1.0.2 and later.
© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)