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

# VistaIONew(3)

allocate storage for an instance of a data type

## NAME

VistaIONew - allocate storage for an instance of a data type

## SYNOPSIS

```
#include <vistaio.h>
```

```
type *VistaIONew (type)
type;
```

## ARGUMENTS

- *type*

  *Specifies a previously declared data type.*

## DESCRIPTION

**VistaIONew** *allocates storage for one instance of a data type. It is*  *a convenience macro that calls* **VistaIOMalloc***(3) with the following* *arguments specified:*

```
((type *) VistaIOMalloc (sizeof (type))
```

## RETURN VALUES

**VistaIONew** *returns a pointer to the allocated storage.*

## SEE ALSO

[**VistaIOMalloc**(3)](/VistaIOMalloc/3.md), [**VistaIONewString**(3)](/VistaIONewString/3.md), [**VistaIOError**(3)](/VistaIOError/3.md),

## DIAGNOSTICS

*If there is insufficient memory to allocate the new block,* **VistaIONew** *terminates by calling* **VistaIOError***(3) with the message \`\`Out of memory''.*

## AUTHOR

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

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

## ACKNOWLEDGMENT

*This macro and this manual page are based on similar ones* *included in the X Toolkit Intrinsics, which is*  *Copyright 1985, 1986, 1987, 1988* *Massachusetts Institute of Technology, Cambridge, Massachusetts,* *and Digital Equipment Corporation, Maynard, Massachusetts.*