1024
Appendix A: System Routines — Symbol Table Utilities
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
MakeHsym
Declaration:
HSYM
MakeHsym
(HANDLE
fHandle
, SYM_ENTRY *
SymEntry
)
Category(ies):
Symbol Table (low-level)
Description:
Given a handle to a folder and a SYM_ENTRY pointer to a symbol in that
folder create an HSYM from both values. An HSYM is basically a
combination of the folder’s handle and the offset of a symbol into that
folder. HSYMs are valid until a symbol is added or removed from the folder
they belong to. Dereferencing an HSYM with
DerefSym
produces a direct
pointer to the symbol table which is valid until heap compression is done.
Inputs:
fHandle
— Handle of folder.
SymEntry
— SYM_ENTRY pointer to symbol.
Outputs:
HSYM representing the given symbol.
Assumptions:
None
Side Effects:
HSYMs are valid until a symbol is added or removed from the folder they
belong to.
Availability:
All versions of the TI
-
89 / TI
-
92 Plus.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: DerefSym
Example:
In this example, SymPtr (a SYM_ENTRY pointer to a specific symbol) must
be maintained. Heap compression would cause the pointer to be invalid
since it is a direct pointer into memory. So the SymPtr is converted to an
HSYM with
MakeHsym
(along with the HANDLE of the folder that the
symbol belongs to). After the code that may cause heap compression is
executed, the HSYM is converted back into a SYM_ENTRY pointer with
DerefSym
.
HANDLE folderHandle;
SYM_ENTRY *SymPtr;
HSYM hsym;
hsym = MakeHsym( folderHandle, SymPtr );
. . . Do something that may cause heap compression . . .
SymPtr = DerefSym( hsym );
To Next Page
Loading...
Need help?
General
