| HeapMoveHigh | Function (ROM Call 0xA0)

alloc.h

HANDLE HeapMoveHigh (HANDLE Handle);

Reallocates a block.

HeapMoveHigh tries to reallocate a block referenced by Handle as high in memory as possible. The block must not be locked. If successful, returns the handle passed; otherwise returns H_NULL (in this case, the block is still in the same place as before, so no memory is lost). This routine will cause heap compression (garbage collection).

Uses: HeapCompress, memmove, NeedStack
Used by: NG_execute, HomeExecute, TE_handleEvent, CustomBegin, push_user_func