NAME¶
VistaIOWriteFile - write a Vista data file
SYNOPSIS¶
#include <stdio>
#include <vistaio.h>
VistaIOBoolean VistaIOWriteFile ( file, list)
FILE * file;
VistaIOAttrList list;
ARGUMENTS¶
- file
- Specifies the open stream to which the data file should be written.
- list
- Specifies the list of attributes to be written.
DESCRIPTION¶
VistaIOWriteFile writes an attribute list as a Vista data file.
Attributes are written in the order that they appear in the list. As they are
written, attribute values are converted from internal form (e.g., a
VistaIOImage data structure) to external form according to the
conventions described by
VistaIOattribute(3) and
VistaIOtype(3).
RETURN VALUE¶
If
VistaIOWriteFile is successful it returns
TRUE.
In this case it will have written everything from the Vista data file header
to the last byte of binary data. If
VistaIOWriteFile encounters an
error, however, it returns
FALSE while perhaps leaving
the file incomplete.
SEE ALSO¶
VistaIOWriteImages(3),
VistaIOWriteObjects(3),
VistaIOWriteUbcIff(3),
stdio(3),
VistaIOtype(3)
NOTES¶
Data is written to the stream sequentially, permitting the stream to be a pipe.
No rewind is performed either before writing or after.
DIAGNOSTICS¶
- ``name attribute has unwriteable representation:
repn.''
- The named attribute has a value that cannot be converted to external form.
A VistaIOPointer value, for example, has no external form.
- ``Write to stream failed.''
- A write to file failed because of an I/O error or a corrupt data
structure.
AUTHOR¶
Art Pope <pope@cs.ubc.ca>
Adaption to vistaio: Gert Wollny <gw.fossdev@gmail.com>