1036
Appendix A: System Routines — Symbol Table Utilities
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
SymFindFoldername
Declaration:
BYTE *
SymFindFoldername
(void)
Category(ies):
Symbol Table Utilities (low-level)
Description:
If calling
SymFindFirst
/
SymFindNext
/
SymFindPrev
to recurse through
the symbol table, then calling this routine will get the name of the folder for
the symbol just returned. Do not call this routine if not using
FO_RECURSE!
Inputs:
None
Outputs:
Pointer to folder name.
Assumptions:
None
Side Effects:
None
Availability:
All versions of the TI
-
89 / TI
-
92 Plus.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: SymFindFirst, SymFindNext, SymFindPrev
Example:
This is the code that is executed when a
HeapWalk
(H_WALK_SYM) is
done. It first saves the symbol table private global structure (SymPG_S),
since it is a static global, and executing the
SymWalk
function, would
modify it, possibly corrupting data used by a calling app. It then walks the
entire symbol table, printing every symbol and folder using
SymFindFoldername
to print the folder of each symbol found. When done
it restores SymPG_S. The purpose of the FINALLY, ENDFINAL section is
to insure that SymPG_S is restored whether an error is generated by
LIO_SendData
or not. The PRINTF macro redirects the output of
SymWalk
to the link port. A PC may capture that output with a gray-link
cable and a terminal emulation program (like HyperTerminal).
(continued)
To Next Page
Loading...
Need help?
General
