HPurge
E736583
HPurge is a memory management API function used to mark relocatable memory blocks as purgeable, allowing the system to reclaim their storage when needed.
Statements (31)
| Predicate | Object |
|---|---|
| instanceOf |
Classic Mac OS Toolbox routine
ⓘ
Memory management API function ⓘ |
| category | Low-level memory management ⓘ |
| definedIn | Macintosh Memory Manager API NERFINISHED ⓘ |
| documentation | Described in Inside Macintosh: Memory ⓘ |
| effect |
Allows system to reclaim storage of a relocatable block
ⓘ
Does not immediately dispose of the block ⓘ Marks a relocatable block as purgeable ⓘ May cause block contents to be discarded when memory is low ⓘ |
| errorHandling | May set memory manager error codes in global variables ⓘ |
| implementedIn | Macintosh ROM / System software NERFINISHED ⓘ |
| memoryModel | Handle-based relocatable heap ⓘ |
| operatesOn |
Handles
ⓘ
Relocatable memory blocks ⓘ |
| platform |
Classic Mac OS System 7 era
ⓘ
Motorola 68k Macintosh NERFINISHED ⓘ |
| precondition |
Handle must be valid
ⓘ
Handle must refer to a relocatable block ⓘ |
| purpose | Helps the system manage limited RAM by reclaiming purgeable blocks ⓘ |
| relatedTo |
DisposeHandle
ⓘ
HLock ⓘ HNoPurge ⓘ HUnlock ⓘ SetHandleSize ⓘ |
| scope | Application heap ⓘ |
| sideEffect |
Does not move the block immediately
ⓘ
May change purgeable status of the block ⓘ |
| usedBy |
Classic Mac OS applications written in C
ⓘ
Classic Mac OS applications written in Pascal ⓘ |
| usedIn |
Classic Mac OS
NERFINISHED
ⓘ
Macintosh Memory Manager NERFINISHED ⓘ |
Referenced by (1)
Full triples — surface form annotated when it differs from this entity's canonical label.