NAME

       VistaIOReadEdges - read a series of edge sets from a stream

SYNOPSIS

       #include <stdio>
       #include <vistaio.h>
       #include <vistaio.h>

       int VistaIOReadEdges (file, attributes, edge_sets)
              FILE *file;
              VistaIOAttrList *attributes;
              VistaIOEdges (*edge_sets)[];

ARGUMENTS

       file      Specifies the open stream from which the edge sets should be read.

       attributes
                 Returns a list of attributes read from the stream.

       edge_sets Returns a vector of pointers to edge sets read.

DESCRIPTION

       VistaIOReadEdges  reads a Vista data file from an open stream, collects the top-level edge
       sets found, and returns the edge sets separately from the file's other contents.

RETURN VALUES

       VistaIOReadEdges returns  the  number  of  edge  sets  obtained,  or  0  if  an  error  is
       encountered.  A vector of the edge sets is allocated and returned via edge_sets. Any other
       objects found in the file are returned as an attribute list via attributes.

SEE ALSO

       VistaIOReadFile(3), VistaIOReadObjects(3), stdio(3),
       VistaIOEdges(3)

DIAGNOSTICS

       Besides the  following,  any  of  the  diagnostics  produced  by  VistaIOReadFile  may  be
       generated.

       ``No edges objects present in stream.''
              No edge sets were encountered in the specified stream.

AUTHOR

       David Lowe <lowe@cs.ubc.ca>

       Adaption to vistaio: Gert Wollny <gw.fossdev@gmail.com>