VistaIOReadEdges(3)

📦 version 1.2.19, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 VistaIOReadEdges 💖

okay bestie, welcome to the VistaIOReadEdges(3) page — she lives in the Library Functions Manual section and she's here to slurp up edge sets from a stream like it's her whole job (it is). 🦋

✨ 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)[];

(yes the #include <vistaio.h> is there twice, that's just how she is, no notes 💅)

✨ ARGUMENTS ✨

  • file — the open stream you wanna read the edge sets from. hand her the stream, she does the rest 🫶
  • attributes — this one's an output bestie: she hands you back a list of attributes that got read from the stream.
  • edge_sets — also an output: a vector of pointers to the edge sets that got read. 😭 iconic

✨ DESCRIPTION ✨

so what she actually does: VistaIOReadEdges reads a Vista data file from an open stream, collects up all the top-level edge sets she finds in there, and gives you those edge sets separately from the rest of the file's contents. like, she's sorting the vibe out for you. no cap. 🔥

✨ RETURN VALUES ✨

She returns the number of edge sets she obtained — or 0 if an error happened, in which case 💀.

A vector of the edge sets gets allocated and returned through edge_sets. And anything else she stumbles across in the file? That comes back as an attribute list via attributes. she's thorough, she's organized, she's the moment 👑

✨ SEE ALSO ✨

go read those too, they're the friend group 🌈

✨ DIAGNOSTICS ✨

on top of the one below, any of the diagnostics that VistaIOReadFile can produce may also show up. so if something's weird, check her too.

``No edges objects present in stream.'' — translated: there were no edge sets at all in the stream you gave her. empty. void. nothing. 🙈

✨ AUTHOR ✨

David Lowe <lowe@cs.ubc.ca>

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

and that's the whole page bestie, you ate it 💖 this was VistaIO Version 1.2.14, dated 4 April 1995 (a vintage queen, lowkey), signed off from the VistaIOReadEdges(3) page. mwah 💅✨

📦 where this page comes from