MA_GET_NEXT_MEMHANDLE
NAME
MA_get_next_memhandle - get the handle for the next block in
the scan of currently allocated blocks
C SYNOPSIS
#include "macdecls.h"
Boolean MA_get_next_memhandle(ithandle, memhandle)
Integer *ithandle; /* read-write */
Integer *memhandle; /* write-only */
FORTRAN SYNOPSIS
#include "mafdecls.h"
logical function MA_get_next_memhandle(ithandle, memhandle)
integer ithandle
integer memhandle
DESCRIPTION
MA_get_next_memhandle() returns in memhandle the handle for
the next block in the scan of currently allocated blocks
corresponding to the iterator handle ithandle (which was
returned by MA_init_memhandle_iterator() when the scan was
initialized).
USAGE
The following FORTRAN code illustrates the use of
MA_get_next_memhandle() 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.
SEE ALSO
MA(3), MA_init_memhandle_iterator(3)
AUTHOR
Gregory S. Thomas, Pacific Northwest Laboratory