Initializing help system before first use

XPRMgetnextident

XPRMgetnextident


Purpose
Get the next identifier in the dictionary.
Synopsis
const char *XPRMgetnextident(XPRMmodel model, void **ref);
Arguments
model 
Reference to a model
ref 
Pointer to an area where current location is stored
Return value
An identifier of the symbol table or NULL if all identifiers have been returned.
Further information
1. This function returns the next identifier held in the internal table of symbols. The second parameter is used to store the current location in the table; this reference is updated with every call to this function. If this parameter references a NULL pointer, the first identifier of the table is returned. This function returns NULL if it is called with the reference to the last identifier in the internal table.
2. The compiler generates automatic names for constant sets (identifiers start with "@") and anonymous types (identifiers start with "%"). This function reports only automatic names of sets, however the other symbols can be accessed using XPRMfindident.
3. When the model or package is compiled with debug information included, local symbols of imported packages are also available (and listed through this function). In order to avoid name collisions each symbol local to a package is prefixed by the package name and the symbol . For instance the symbol myctr defined in the package mypkg is stored as mypkg∼myctr.
4. This function enumerates only globally defined symbols. To get a list of local symbols (like a loop index) during a debugging session use XPRMdbg_getnextlocal.
Related topics