---
name: "VistaIOReadObjects"
section: "3"
platform: "linux"
package: "libvistaio-dev"
version: "1.2.19-3+b2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/VistaIOReadObjects"
---

# VistaIOReadObjects(3)

read a series of objects from 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*

  **Specifies the open stream from which the objects should be read.**

- *repn*

  **Specifies the kind of objects sought.**

- *attributes*

  **Returns a list of attributes read from the stream.**

- *edge\_sets*

  **Returns a vector of pointers to the objects read.**

## DESCRIPTION

**VistaIOReadObjects reads a Vista data file from an open stream, collects all**  **top-level objects of the type specified by** *repn***, and returns those**  **objects separately from the file's other contents. It is used by**  **VistaIOReadImages, for example, to read and collect images by specifying**  **VistaIOImageRepn for the** *repn* **argument.**

## RETURN VALUES

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

## SEE ALSO

**VistaIOOpenInputFile**(3), [**VistaIOReadEdges**(3)](/VistaIOReadEdges/3.md), [**VistaIOReadFile**(3)](/VistaIOReadFile/3.md), [**VistaIOReadImages**(3)](/VistaIOReadImages/3.md), [**VistaIOWriteObjects**(3)](/VistaIOWriteObjects/3.md), [**stdio**(3)](/stdio/3.md)

## DIAGNOSTICS

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

- \`\`No *type* objects present in stream.''

  **No objects of the type specified by** *repn* **were encountered in the**  **stream.**

## AUTHOR

**Art Pope \<pope@cs.ubc.ca\>**

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