Texas Instruments TI-89 - Heapmax

856
Appendix A: System Routines — Memory Management
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
HeapMax
Declaration:
DWORD
HeapMax
(void)
Category(ies):
Memory Management
Description:
Return the largest block of memory available to allocate (calls
HeapCompress
first).
Inputs:
None
Outputs:
The largest block of memory that may be allocated with one of the heap
allocation routines (like
HeapAlloc
,
HeapAllocThrow
, . . . ). This will be in
the range 0 . . . 65520.
Assumptions:
None
Side Effects:
Compresses the heap.
Availability:
All versions of the TI
-
89 / TI
-
92 Plus.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: HeapAlloc, HeapAllocThrow, HeapAvail, HeapCompress
Example:
if (HeapMax() < 20000) {
myErrorMsg( "NOT enough memory to allocate large array" );
return FALSE;
}