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 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
noErr0No error
memFullErr-108Not enough memory

Previous Book Contents Book Index Next

© Apple Computer, Inc.
3 JUL 1996