NAME
cxDataMalloc
- allocate space from IRIS Explorer data memory
C SPECIFICATION
#include <cx/DataOps.h>
void *cxDataMalloc(size_t size)
FORTRAN SPECIFICATION
integer function cxDataMalloc(size)
integer size
PARAMETERS
-
size
-
size of memory block to be allocated.
DESCRIPTION
cxDataMalloc returns a pointer to a block of IRIS Explorer data
memory of at least size bytes.
Depending on machine architecture the
space may be allocated from a shared memory arena.
Otherwise space will be allocated from the module's normal data space.
Shared memory is a fixed resource, so it is possible for the
allocation to fail if the shared memory is exhausted.
When this happens, cxDataMalloc returns NULL, and a subsequent
call to cxDataAllocErrorGet will return non-zero.
SEE ALSO
cxDataRealloc(3E),
cxDataCalloc(3E),
cxDataFree(3E),
cxDataAllocErrorGet(3E)
Last modified: Mon Nov 18 13:48:04 GMT 1996
[ Documentation Home ]
© The Numerical Algorithms Group Ltd, Oxford UK. 1996