UILDUMPSYMBOLTABLE(3)

💖 UilDumpSymbolTable 💖

okay bestie, so this one is a library call from the UIL crew, and it's literally just "show me everything inside this symbol table, right now, on my screen". no cap.

---

✨ NAME ✨

UilDumpSymbolTable — Dumps the contents of a named UIL symbol table to standard output 🫶

---

🌸 SYNOPSIS 🌸

#include <uil/UilDef.h>

void UilDumpSymbolTable(
sym_entry_type *root_ptr);

---

🦋 DESCRIPTION 🦋

so the UilDumpSymbolTable function dumps the contents of a UIL symbol table pointer to standard output. that's it, that's the whole vibe. it prints, you read, slay. 💅

• root_ptr — this is a pointer to the the symbol table root entry. (yes, the original says "the the", we don't fix it, we respect it ✨) you can grab this value from the parse_tree_root part of the Uil_compile_desc_type data structure that Uil hands back to you.

ngl, this is the fun part: by following the link from the root entry, you can traverse the entire parse tree. it's giving main character energy for the whole tree. 🌳

symbol table entries come out in this format:

hex.address symbol.type symbol.data prev.source.position source.position modification.record

where:

• hex.address — the hexadecimal address of this entry in the symbol table. it's the entry's little home address. 🏠
• symbol.type — the type of this symbol table entry. some possible types are root, module, value, procedure, and widget. so many icons honestly. 👑
• symbol.data — the data for the symbol table entry. and lowkey the data varies with the type of the entry. often it contains pointers to other symbol table entries, or the actual data for the data type. it's a mystery box, we love her. 🎁
• prev.source.position — the end point in the source code for the previous source item.
• source.position — the range of positions in the source code for this symbol. 📍

and yeah, the format line also has a modification.record field chilling in there at the end — that's just part of the line, bestie, i'm not gonna make up lore about it. 🙈

heads up: the exact data structures for each symbol type are defined in the include file UilSymDef.h. and note that this file is automatically included when an application includes the file UilDef.h. so you don't gotta do it twice. one include, two files, that's the deal. 🧚

---

💜 RELATED 💜

• Uil(3)

---

and that's the whole page, bestie!! this was the UilDumpSymbolTable(library call) manual page, living its life in the library call section of the manual. go dump a symbol table, you absolute legend. periodt. 💅✨🎀🦋