Gan_Bool gan_vec3_fprint ( FILE *fp, Gan_Vector3 *p,
const char *prefix, int indent, const char *fmt );
prefix is a prefix string to print before the vector itself, indent
is the number of spaces to indent the vector by, and fmt is a format
string to use when printing the vector, e.g. "%f". So for example
FILE *pfFile;
pfFile = fopen ( "/tmp/vectors", "w" );
gan_vec3_fill_q ( &v3x, 1.0, 2.0, 3.0 );
gan_vec3_fprint ( pfFile, &v3x, "Example vector", 3, "%f" );
will print the output
Example vector: 1.000000 2.000000 3.000000
to the file "/tmp/vectors".
There is also a version gan_vec3_print() for printing to
standard output:
Gan_Bool gan_vec3_print ( Gan_Vector3 *p,
const char *prefix, int indent, const char *fmt );
The corresponding input function is
Gan_Bool gan_vec3_fscanf ( FILE *fp, Gan_Vector3 *p,
char *prefix, int prefix_len )
which reads the vector from the file stream fp into the 3-vector
pointer p. It also reads the prefix string (up to the specified maximum
length prefix_len), which can be compared with the expected prefix
string to check for consistency.
Binary file I/O is handled by the functions gan_vec3_fwrite() and gan_vec3_fread(). To write a 3-vector in binary format use
Gan_Bool gan_vec3_fwrite ( FILE *fp, Gan_Vector3 *p, gan_ui32 magic_number );
The magic_number takes the same role as the prefix string
in gan_vec3_fprint(), and is written into the file so that it can be
used later to identify the vector when it is read back using
Gan_Bool gan_vec3_fread ( FILE *fp, Gan_Vector3 *p, gan_ui32 *magic_number );
Error detection: The I/O routines return a boolean value, returning GAN_TRUE on success, GAN_FALSE on failure, invoking the Gandalf error handle in the latter case.