symEnter basic EMF

Synopsis

Adds a lookup-value pair to a symbol table

Prototype

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, update the value. 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");

See Also

symClose, symDelete, symFirst, symLookup, symNext, symOpen