symEnter -- basic

symEnter

basic

EMF

Synopsis

Adds a lookup-value pair to a symbol table.

Prototype

 #include "uemf.h"

 sym_t *symEnter(sym_fd_t sd, char_t* name, value_t v, 
      int args);

Parameters

sd	Handle to the table created from a previous call to symOpen.
name	The string lookup key for future calls to symLookup.
v	The value to be stored in the symbol table.
args	Args.

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.

Enters a new or existing symbol into the table. If the symbol is already there, it updates the value and the previous value is freed by valueFree . Always succeeds if enough memory is available.

Return Value

Returns a pointer to a sym_t structure that contains the new entry.

Example

sym_fd_t id;
sym_t* sp;

id = symOpen(64);
...

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

sp = symLookup(id, "lookup");

Stability Classification

Evolving.