MA_INITIALIZE_MEMHANDLE_ITERATOR
NAME
MA_init_memhandle_iterator - initialize a scan of currently
allocated blocks
C SYNOPSIS
#include "macdecls.h"
Boolean MA_init_memhandle_iterator(ithandle)
Integer *ithandle; /* write-only */
FORTRAN SYNOPSIS
#include "mafdecls.h"
logical function MA_init_memhandle_iterator(ithandle)
integer ithandle
DESCRIPTION
MA_init_memhandle_iterator() returns in ithandle the
iterator handle for a scan of currently allocated blocks.
USAGE
The following FORTRAN code illustrates the use of
MA_init_memhandle_iterator() by looping over all currently
allocated blocks.
#include "mafdecls.h"
logical ok
integer ihandle
integer mhandle
ok = MA_init_memhandle_iterator(ihandle)
if (ok) then
ok = MA_get_next_memhandle(ihandle, mhandle)
10 if (ok) then
... process mhandle
ok = MA_get_next_memhandle(ihandle, mhandle)
goto 10
endif
endif
RETURN VALUE
C: MA_TRUE upon success, MA_FALSE upon failure.
FORTRAN: .true. upon success, .false. upon failure.
NOTES
This routine is not yet implemented.
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_get_next_memhandle(3)
AUTHOR
Gregory S. Thomas, Pacific Northwest Laboratory