CFDataCreateCopy(_:_:)
Creates an immutable copy of a CFData object.
Declaration
func CFDataCreateCopy(_ allocator: CFAllocator!, _ theData: CFData!) -> CFData!Parameters
- allocator:
The allocator to use to allocate memory for the new object. Pass
NULLor kCFAllocatorDefault to use the current default allocator. - theData:
The CFData object to copy.
Return Value
An immutable copy of theData, or NULL if there was a problem creating the object. Ownership follows the The Create Rule.
Discussion
The resulting object has the same byte contents as the original object, but it is always immutable. If the specified allocator and the allocator of the original object are the same, and the string is already immutable, this function may simply increment the retain count without making a true copy. To the caller, however, the resulting object is a true immutable copy, except the operation was more efficient.
Use this function when you need to pass a CFData object into another function by value (not reference).