Legacy Document

Inside Macintosh: Memory /

Chapter 2 - Memory Manager / Memory Manager Reference

Memory Manager Routines / Allocating and Releasing Nonrelocatable Blocks of Memory

NewPtrClear

You can use the NewPtrClear function to allocate prezeroed memory in a nonrelocatable block of a specified size.

FUNCTION NewPtrClear (logicalSize: Size): Ptr;

logicalSize

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

DESCRIPTION

The NewPtrClear function works much as the NewPtr function does, but sets all bytes in the new block to 0 instead of leaving the contents of the block undefined.

Currently, NewPtrClear clears the block one byte at a time. For a large block, it might be faster to clear the block manually a long word at a time.

RESULT CODES

noErr	0	No error
memFullErr	-108	Not enough memory