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

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

QuickDraw 3D Routines / Managing Strings

Q3CString_SetString

You can use the Q3CString_SetString function to set the character data of a C string object.

TQ3Status Q3CString_SetString (
TQ3StringObject stringObj, 
const char *string);

stringObj

A C string object.

string

On entry, a pointer a C string specifying the character data to be associated with the specified C string object.

DESCRIPTION

The Q3CString_SetString function sets the character data associated with the C string object specified by the stringObj parameter to the sequence of characters pointed to by the string parameter. That sequence of characters should be a standard C string (that is, an array of characters terminated by the null character). The characters are copied into the specified string object's private data, so you can dispose of the array pointed to by the string parameter if Q3CString_SetString returns successfully.

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