Legacy Documentclose button

Important: The information in this document is obsolete and should not be used for new development.

Previous Book Contents Book Index Next

Inside Macintosh: Memory /
Chapter 2 - Memory Manager / Memory Manager Reference
Memory Manager Routines / Allocating and Releasing Relocatable Blocks of Memory


NewHandleSysClear

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

FUNCTION NewHandleSysClear (logicalSize: Size): Handle;
logicalSize
The requested size (in bytes) of the relocatable block. The NewHandleSysClear function sets each of these bytes to 0.
DESCRIPTION
The NewHandleSysClear function works much as the NewHandleClear function does, but attempts to allocate the requested block in the system heap zone instead of in the current heap zone. NewHandleSysClear sets all bytes in the new block to 0 instead of leaving the contents of the block undefined.

RESULT CODES
noErr0No error
memFullErr-108Not enough memory in heap zone

Previous Book Contents Book Index Next

© Apple Computer, Inc.
3 JUL 1996