MA_INQUIRE_AVAIL(3)

NAME
MA_inquire_avail - find out how much free space is available between the heap and stack regions

C SYNOPSIS
#include "macdecls.h"
Integer MA_inquire_avail(datatype)
    Integer     datatype;       /* read-only */

FORTRAN SYNOPSIS
#include "mafdecls.fh"
integer function MA_inquire_avail(datatype)
    integer     datatype

DESCRIPTION
MA_inquire_avail() returns the maximum number of elements of type datatype that can currently be allocated in the space between the heap and stack, in a single allocation request, ignoring the partition defined at initialization. Note that this might not be the largest piece of memory available; the heap may contain deallocated blocks that are larger.

DIAGNOSTICS
MA not yet initialized
MA_init() must be called before this routine is called.
invalid datatype: %d
datatype must be one of those listed in macdecls.h or mafdecls.fh.

RETURN VALUE
C: The number of elements, as described above.
FORTRAN: The number of elements, as described above.

FILES
Include files: /msrc/proj/hpctools/ma/release/current/include
Library:       /msrc/proj/hpctools/ma/release/current/lib/platform/libma.a
Man pages:     /msrc/proj/hpctools/ma/release/current/man/man3
Source code:   /msrc/proj/hpctools/ma/release/current/tar/marelease.tar

SEE ALSO
MA(3), MA_inquire_heap(3), MA_inquire_stack(3)

AUTHOR
Gregory S. Thomas, Pacific Northwest National Laboratory