Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

UilDumpSymbolTable(3X)  —  OSF/Motif

NAME

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

SYNOPSIS

#include <uil/UilDef.h>
void UilDumpSymbolTable (root_ptr)
sym_entry_type *root_ptr;

DESCRIPTION

The UilDumpSymbolTable function dumps the contents of a UIL symbol table pointer to standard output. 

root_ptrSpecifies a pointer to the the symbol table root entry.  This value can be taken from the parse_tree_root part of the Uil_compile_desc_type data structure returned by Uil. 

By following the link from the root entry, you can traverse the entire parse tree.  Symbol table entries are in the following format:

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

where:

hex.addressSpecifies the hexadecimal address of this entry in the symbol table. 

symbol.typeSpecifies the type of this symbol table entry.  Some possible types are root, module, value, procedure, and widget. 

symbol.dataSpecifies data for the symbol table entry.  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. 

prev.source.positionSpecifies the end point in the source code for the previous source item. 

source.positionSpecifies the range of positions in the source code for this symbol. 

The exact data structures for each symbol type are defined in the include file UilSymDef.h.  Note that this file is automatically included when an application includes the file UilDef.h. 

RELATED INFORMATION

Uil(3X)

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026