Texas Instruments TI89 Developer Guide - Page 1078

1036 Appendix A: System Routines - Symbol Table Utilities SymFindFoldername Declaration: BYTE * SymFindFoldername (void) Category(ies): Description: Inputs: Outputs: Symbol Table Utilities (low-level) 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! None 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: Example: SymFindFirst, SymFindNext, SymFindPrev 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) TI-89 / TI-92 Plus Developer Guide Not for Distribution Beta Version January 26, 2001