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>