Important: The information in this document is obsolete and should not be used for new development.
NewHandleClear
You can use theNewHandleClear
function to allocate prezeroed memory in a relocatable block of a specified size.
FUNCTION NewHandleClear (logicalSize: Size): Handle;
logicalSize
- The requested size (in bytes) of the relocatable block. The
NewHandleClear
function sets each of these bytes to 0.DESCRIPTION
TheNewHandleClear
function works much as theNewHandle
function does but sets all bytes in the new block to 0 instead of leaving the contents of the block undefined.Currently,
NewHandleClear
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 in heap zone