CFDataGetBytePtr

Header: CFData.h Carbon status: Supported

Obtains a pointer to the bytes of a CFData object. The bytes cannot be modified.

const UInt8 *CFDataGetBytePtr (
    CFDataRef data
);
Parameter descriptions
data

Pass a reference to the CFData object whose byte contents you wish to access.

function result

A pointer to a read-only byte buffer.

DISCUSSION

This function either returns the requested pointer immediately, with no memory allocations and no copying, or it returns NULL. If the latter is the result, call the CFDataGetBytes function to copy the byte contents to an external buffer.

Whether the CFDataGetBytePtr function returns a valid pointer or NULL depends on many factors, all of which depend on how the object was created. In addition, the function result might change between different releases and on different platforms. So do not count on receiving a non-NULL result from this function under any circumstances.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later.


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