Carbon


DisposePtr

Header: MacMemory.h Carbon status: Supported

Releases memory occupied by a nonrelocatable block.

void DisposePtr (
    Ptr p
);
p

A pointer to the nonrelocatable block you want to dispose of.

DISCUSSION

When you no longer need a nonrelocatable block, call the DisposePtr function to free it for other uses.

Call the function MemError to get the result code. See “Result Codes”.

After a call to DisposePtr, all pointers to the released block become invalid and should not be used again. Any subsequent use of a pointer to the released block might cause a system error.

Because DisposePtr purges memory, you should not call it at interrupt time.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when InterfaceLib 7.1 or later is installed. Exported by CarbonLib 1.0 and later and by InterfaceLib 7.1 and later.


© 2000 Apple Computer, Inc. — (Last Updated 4/6/2000)