.ds Vv 1.2.14
.TH VistaIOReadEdges 3 "4 April 1995" "VistaIO Version \*(Vv"
.SH NAME
VistaIOReadEdges \- read a series of edge sets from a stream
.SH SYNOPSIS
.nf
.ft B
#include \fB<stdio>\fP
#include \fB<vistaio.h>\fP
#include \fB<vistaio.h>\fP
.PP
.ft B
int VistaIOReadEdges (\fIfile\fP, \fIattributes\fP, \fIedge_sets\fP)
.RS
FILE *\fIfile\fP;
VistaIOAttrList *\fIattributes\fP;
VistaIOEdges (*\fIedge_sets\fP)[];
.RE
.fi
.SH ARGUMENTS
.IP \fIfile\fP 10n
Specifies the open stream from which the edge sets should be read.
.IP \fIattributes\fP
Returns a list of attributes read from the stream.
.IP \fIedge_sets\fP
Returns a vector of pointers to edge sets read.
.SH DESCRIPTION
\fBVistaIOReadEdges\fP 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. 
.SH "RETURN VALUES"
\fBVistaIOReadEdges\fP 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 
\fIedge_sets\fP. Any other objects found in the file are returned as an 
attribute list via \fIattributes\fP. 
.SH "SEE ALSO"
.na
.nh
.BR VistaIOReadFile (3),
.BR VistaIOReadObjects (3),
.BR stdio (3),
.br
.BR VistaIOEdges (3)

.ad
.hy
.SH DIAGNOSTICS
Besides the following, any of the diagnostics produced by \fBVistaIOReadFile\fP 
may be generated.
.IP "``No edges objects present in stream.''"
No edge sets were encountered in the specified stream.
.SH AUTHOR
David Lowe <lowe@cs.ubc.ca>

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