17 Reading and Writing File Data

17 Q3String_Read

You can use the Q3String_Read function to read a string from a file object.

TQ3Status Q3String_Read (
char *data, 
unsigned long *length, 
TQ3FileObject file);
data On entry, a pointer to a buffer whose length is of size kQ3StringMaximumLength, or NULL. On exit, a pointer to the string read from the specified file object. If this parameter is set to NULL on entry, no string is read, but its length is returned in the length parameter.
length On exit, the number of characters actually copied into the specified buffer. If data is set to NULL on entry, this parameter returns the length of the string.
file A file object.

DESCRIPTION


The Q3String_Read function returns, in the data parameter, a pointer to the next string in the file object specified by the file parameter. The string data is 7-bit ASCII, with standard escape sequences for any special characters in the string. The Q3String_Read function also returns, in the length parameter, the length of the string.

DESCRIPTION

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

© Apple Computer, Inc.

Let us know what you think of these prototype pages.

Generated with Harlequin WebMaker