Legacy Document

Inside Macintosh: Memory /

Chapter 2 - Memory Manager / Memory Manager Reference

Memory Manager Routines / Allocating and Releasing Nonrelocatable Blocks of Memory

NewPtrSysClear

You can use the NewPtrSysClear function to allocate, in the system heap, prezeroed memory in a nonrelocatable block of a specified size.

FUNCTION NewPtrSysClear (logicalSize: Size): Ptr;

logicalSize

The requested size (in bytes) of the nonrelocatable block.

DESCRIPTION

The NewPtrSysClear function works much as the NewPtr function does, but attempts to allocate the requested block in the system heap zone instead of in the current heap zone. Also, it sets all bytes in the new block to 0 instead of leaving the contents of the block undefined.

RESULT CODES

noErr	0	No error
memFullErr	-108	Not enough memory