Texas Instruments TI-89 Developer's Guide

Appendix A: System Routines — Memory Management
861
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
HeapSize
Declaration:
DWORD
HeapSize
(HANDLE
handle
)
Category(ies):
Memory Management
Description:
Return the number of bytes allocated for the given heap block. Due to word
alignment and minimum block size, this may not be the amount it was
allocated with. Note that heap compression itself can in rare circumstances
increase the size of a heap block by a couple of bytes; therefore it is best
not to rely on
HeapSize
to determine the true size of a block of heap
memory.
Inputs:
handle
— Handle of a heap block allocated with one of the heap
allocation routines.
Outputs:
Size of block of heap memory for
handle
.
Assumptions:
None
Side Effects:
None
Availability:
All versions of the TI
-
89 / TI
-
92 Plus.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: HeapAlloc, HeapAllocThrow, HeapRealloc
Example:
HANDLE h1, h2;
DWORD s1, s2;
h1 = HeapAlloc( 4 );
s1 = HeapSize( h1 ); /* will be 8 since that is the minimum block size */
h2 = HeapAlloc( 11 );
s2 = HeapSize( h2 ); /* will be 12 since all blocks must be even in length */

Texas Instruments TI-89 Specifications

General

Display size (HxV)	100 x 160 mm
Memory type	639K FLASH ROM, 188K bytes RAM
Compatible operating systems	Operating System 2.09
Battery type	AAA