SymFindFolderName Function (ROM Call 0x6F)

vat.h

char *SymFindFolderName (void);

Returns an actual folder name during browsing through the VAT table.

This routine is used only when you search the complete VAT table using functions SymFindFirst, SymFindNext and SymFindPrev with FO_RECURSE in Flags set. Each time when a folder is encountered in the VAT table, the TIOS stores its name in an internal buffer. Later, when you go through the variable part of the VAT table, you can call this routine to retrieve the stored folder name, i.e. to get the name of the folder for the symbol just returned. Under any other conditions, SymFindFolderName just returns a pointer to the string "main".

See HeapWalk for an example using this function.


Uses: IsMainFolderStr, ER_catch, ER_success, ER_throwVar, next_expression_index, push_parse_text, top_estack, strcat, strchr, OSDisableBreak, OSEnableBreak
Used by: HeapWalk, ERD_process, LIO_Receive, OSLinkCmd


Deprecated alias: SymFindFoldername