Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 1 - Introduction to QuickDraw 3D / QuickDraw 3D Reference

QuickDraw 3D Routines / Managing Strings

Q3CString_EmptyData

You can use the Q3CString_EmptyData function to dispose of the memory allocated by a previous call to Q3CString_GetString.

TQ3Status Q3CString_EmptyData (char **string);

string

On entry, a pointer to a copy of the character data returned by a previous call to Q3CString_GetString. On exit, the value NULL.

DESCRIPTION

The Q3CString_EmptyData function deallocates the memory pointed to by the string parameter. The value of the string parameter must have been returned by a previous call to the Q3CString_GetString function. If successful, Q3CString_EmptyData sets the value of the string parameter to NULL. Thus, you can alternate calls to Q3CString_GetString and Q3CString_EmptyData without explicitly setting the character pointer to NULL.

You should use Q3CString_EmptyData only with string objects of type kQ3StringTypeCString.