NewHandleSysClear

Allocate cleared relocatable block from system heap

zone

#include <Memory.h> Memory Manager

Size dataSize ; desired size for the data (a 32-bit value)

returns handle leading to allocated area; NIL if it couldn't

allocate the memory.

NewHandleSysClear is a variation on the routine NewHandle. It

performs just as NewHandle does, except that it uses the system heap to

allocate the handle and it fills the allocated block with zero (0).

dataSize is the desired size for the allocated data area. The allocated block

actually occupies up to 12 bytes more than dataSize .

Returns: a generic Handle (a pointer to a pointer to a data area; officially,

Handle is a typedef for char **). If the area cannot be allocated,

the return value is NIL (0).

Notes: See NewHandle for more information.

Referenced by (3):