Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-FileMalloc()
Mxalloc()
Mfree()                                                              GEMDOS

Syntax

WORD Mfree( startadr )
VOIDP startadr;

Function      Mfree() releases a block of memory previously reserved with
              Malloc() or Mxalloc() back into the GEMDOS free list.

Opcode        73 (0x49)

Availability  All GEMDOS versions.

Parameters    startadr is the starting address of the block to be freed.
              This address must be the same as that returned by the
              corresponding Malloc() or Mxalloc() call.

Binding       pea      startadr
              move.w   #$49,-(sp)
              trap     #1
              addq.   #6,sp

Return Value  Mfree() returns E_OK (0) if the block was freed successfully
              or a negative GEMDOS error code otherwise.

See Also      Malloc(), Mxalloc()