VistaIOReadObjects(3)

✨ VistaIOReadObjects — the manual page, but make it cute ✨

okay bestie, this is VistaIOReadObjects(3) from the Library Functions Manual and it's literally about reading a whole lil squad of objects out of a stream 🎀

🌸 NAME 🌸

VistaIOReadObjects — read a series of objects from a stream 🦋

✨ SYNOPSIS ✨

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

int VistaIOReadObjects (file, repn, attributes, objects)
       FILE *file;
       VistaIORepnKind repn;
       VistaIOAttrList *attributes;
       VistaIOPointer (*objects)[];

💅 ARGUMENTS 💅

• file — the open stream you wanna read the objects from. it's already open, that's your job, not hers 💖
• repn — the kind of objects you're hunting for. yes it's giving very "what's your type" energy 👑
• attributes — this one gives back a list of attributes that got read from the stream 🎀
• edge_sets — returns a vector of pointers to the objects that got read ✨

🌈 DESCRIPTION 🌈

So VistaIOReadObjects reads a Vista data file from an open stream, collects all the top-level objects of the type you specified with repn, and hands those objects back to you separately from everything else chillin' in the file. periodt 💅

It's used by VistaIOReadImages, for example, to read and collect images — you just pass VistaIOImageRepn for the repn argument and it ate 🔥

💜 RETURN VALUES 💜

VistaIOReadObjects returns the number of objects obtained, or 0 if an error shows up 😭 A vector of the objects gets allocated and returned via objects. Any other objects hanging out in the file come back as an attribute list via attributes. no cap 🫶

🦋 SEE ALSO 🦋

• VistaIOOpenInputFile(3)
• VistaIOReadEdges(3)
• VistaIOReadFile(3)
• VistaIOReadImages(3)
• VistaIOWriteObjects(3)
• stdio(3)

⭐ DIAGNOSTICS ⭐

besides the following, any of the diagnostics produced by VistaIOReadFile may show up 🙈

• No type objects present in stream.'' `` — no objects of the type specified by repn were encountered in the stream. it's giving empty 😭

👑 AUTHOR 👑

Art Pope <pope@cs.ubc.ca> 💖

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

and that's a wrap bestie 🎀 this page is from VistaIO Version 1.2.14, dated 24 April 1993 — vintage but still iconic, fr fr ✨💅