symLookup -- basic

symLookup

basic

EMF

Synopsis

Finds a value from a symbol table given the lookup key.

Prototype

 #include "uemf.h"

 sym_t *symLookup(sym_fd_t sd, char_t* aname);

Parameters

sd	Handle to the table created from a previous call to symOpen.
aname	The string lookup key that was set by symEnter.

Description

This module implements a highly efficient generic symbol table with update and access routines. Symbols are simple character strings and the values they take can be flexible types as defined by value_t. This module allows multiple symbol tables to be created.

Return Value

Returns a pointer to a sym_t structure which contains the value. NULL if not found.

Example

sym_fd_t id;
sym_t* sp;

id = symOpen(64);
...

symEnter(id, "lookup", valueString("value"), 0);
...

sp = symLookup(id, "lookup");

Stability Classification

Evolving.