VistaIOWriteEdges(3)

πŸ’Ύ VistaIOWriteEdges β€” bestie edition πŸ’Ύ

okay so picture this: you're in the Library Functions Manual section of the man pages (that's the (3) vibe, iykyk) and you just wanna dump a whole bunch of edge sets into a stream. that's literally it. that's the whole girl. πŸ¦‹


✨ NAME ✨

VistaIOWriteEdges β€” write a series of edge sets to a stream πŸ’…


🌸 SYNOPSIS 🌸

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

VistaIOBoolean VistaIOWriteEdges (file, attributes, nedges, edges)
       FILE *file;
       VistaIOAttrList attributes;
       int nedges;
       VistaIOEdges edges[nedges];
not me spotting <vistaio.h> listed twice β€” yeah, that's literally how it is in the original, so I'm keeping it exactly like that, no cap. 🫢

πŸŽ€ ARGUMENTS πŸŽ€

  • file β€” the open stream you want the edges written to. like, the destination, bestie. 🌈
  • attributes β€” a list of attributes that get written to the stream too. πŸ“
  • nedges β€” how many edge sets you're writing. the count. the number. the receipts. πŸ”’
  • edges β€” the actual edge sets being written. the main characters, honestly. πŸ‘‘

πŸ’– DESCRIPTION πŸ’–

VistaIOWriteEdges writes a series of edge sets to an open stream as a Vista data file. πŸ’Ύβœ¨

so here's the order, and the order matters: the edge sets edges[0] through edges[nedges - 1] get written, and then any attributes in the attributes list come after them. edges first, attributes after. periodt. πŸŽ€

and the tea on attributes: it can totally be NULL if you're only writing edge sets and nothing else. so if it's just edges, you're fine, no worries. πŸ’…


🫢 RETURN VALUES 🫢

VistaIOWriteEdges returns TRUE if it succeeded and FALSE otherwise. 🌟

okay but real talk β€” if there's an error, the data written to the stream may be incomplete. so like, don't trust a half-written stream, bestie. check that return value. 😭

πŸ”₯ SEE ALSO πŸ”₯


πŸ‘‘ AUTHOR πŸ‘‘

David Lowe <lowe@cs.ubc.ca> πŸ’œ

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


and that's the whole page, babe β€” this was VistaIO Version 1.2.14, dated 24 April 1993, which is iconic in a vintage kinda way. slay, go write those edges. πŸ’…πŸŒˆπŸ’–