CFDataCreateMutableCopy

Header: CFData.h Carbon status: Supported

Creates a mutable CFData object by copying another CFData object.

CFMutableDataRef CFDataCreateMutableCopy (
    CFAllocatorRef allocator, 
    CFIndex capacity, 
    CFDataRef data
);
Parameter descriptions
allocator

Pass a reference to an allocator object or pass NULL to request the current default allocator.

capacity

An integer specifying the maximum number of bytes the object should contain. Pass zero to indicate that there should be no limit (other than typical memory and address-space constraints) on the number of bytes contained. Note that initially the created CFData object still has the same length as the original object; this parameter simply specifies what the maximum size is. CFData might try to optimize its internal storage by paying attention to this value.

data

Pass a reference to the CFData object to be copied.

function result

A reference to a mutable CFData object that has the same contents as the original object. Returns NULL if there was a problem copying the object.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later.


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