![]() |
CFCopyDescription | Header: CFBase.h |
Obtains the description of a Core Foundation object. You can use this function to debug code containing Core Foundation object.
CFStringRef CFCopyDescription ( CFTypeRef cf );
A generic reference of type CFTypeRef. Pass a reference to any Core Foundation object whose description you want.
A reference to a CFString object that contains the description.
The CFCopyDescription function provides a textual description of a Core Foundation object. The nature of the description differs by object. For instance, a description of a CFArray object would include descriptions of each of the elements in the collection.
You can use the CFCopyDescription function for debugging Core Foundation objects in your code. Use an appropriate function in String Services to "extract" the character string contained in the returned description. Then print this string to a suitable console or output device.
Do not create dependencies in your code on the content or format of the information returned by CFCopyDescription. The descriptions could change in a later release.
Because you are receiving a copy of the reference to the string object containing the description, you are responsible for releasing the object when your are finished with it.