jammy (3) VistaIOWriteFile.3.gz

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>