Reference: IVEShmAlloc

Overview

Dynamically allocates memory from an IVEArena.

Prototype (C)

#include "ive_shm.h"
void* IVEShmAlloc(IVEArenaSize sz, IVEArena arena);

Prototype (Fortran)

There is no Fortran interface.

Parameters

sz

sz is the number of bytes to allocate from arena.

arena

arena is the arena on which to operate.

Return value

If unsuccessful, returns zero; otherwise, returns a pointer to a region sufficient for storage of at least sz bytes. The initial location of the region is aligned for storage of any intrinsic or compound type. The initial contents of the allocated region are not defined. When the allocated region is no longer needed, it may be recycled with IVEShmDealloc.

Cross references

IVEShmCalloc, IVEShmDealloc, IVEArena, and IVEArenaSize.

| categories | alphabetical |

modified July 1, 2001