Symfindfoldername - Texas Instruments TI-89 Developer's Manual

1036

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).
TI-89 / TI-92 Plus Developer Guide
Appendix A: System Routines — Symbol Table Utilities
(continued)
Not for Distribution Beta Version January 26, 2001