MA_GET_NEXT_MEMHANDLE(3)

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.fh"
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.fh"
    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_init_memhandle_iterator(3)

AUTHOR
Gregory S. Thomas, Pacific Northwest National Laboratory