1 Managing Strings

1 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.

DESCRIPTION

3D Graphics Programming with QuickDraw 3D - 14 OCT 1995

© Apple Computer, Inc.

Let us know what you think of these prototype pages.

Generated with Harlequin WebMaker