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