XPRMgetnextident
XPRMgetnextident |
Purpose
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