Technical data

VSIM function descriptions
ModelSim EE/PLUS Reference Manual VHDL Foreign Language Interface and Verilog PLI
-
471
then the following call returns the string “$abc/xyz”:
mti_FindProjectEntry(“myconfig”, “myentry”, 0)
The function returns NULL if the project entry does not exist.
regionID mti_FindRegion(char *nm)
Returns the regionID for the region identified by nm. The region name may be either a full
hierarchical name or a relative name. A relative name is relative to the region set by the
VSIM
environment
command (p312) (the top level region is the default). NULL is
returned if the region is not found. The operation is the same for Verilog instances.
signalID mti_FindSignal(char *nm)
Returns the signalID for the signal identified by nm. The signal name may be either a full
hierarchical name or a relative name. A relative name is relative to the region set by the
VSIM
environment
command (p312) (the top level region is the default). NULL is
returned if the signal is not found.
varID mti_FindVar(char *nm)
Returns the varID for the variable identified by nm. The variable name may be either a full
hierarchical name or a relative name. The variable name must include the process label. A
relative name is relative to the region set by the VSIM
environment
command (p312) (the
top level region is the default). NULL is returned if the variable is not found.
regionID mti_FirstLowerRegion(regionID reg)
Returns the regionID of the first subregion in this region. Returns NULL if there are no
subregions. See mti_NextRegion. The operation is the same for Verilog instances.
processID mti_FirstProcess(regionID)
Returns the processID of the first process in this region.
signalID mti_FirstSignal(regionID reg)
Returns the signalID of the first signal in this region. Returns NULL if there are no signals
in this region. See mti_NextSignal.
void mti_Free (void *p)
Returns the block of memory to the MTI memory allocator. You cannot use mti_Free for
memory allocated with direct calls to malloc, and you cannot use a direct call to free for
memory allocated with mti_Free.
void * mti_GetArraySignalValue(signalID sig, void *buf)
Gets the value of an array signal. If buf is NULL, then VSIM allocates memory for the
value and returns a pointer to it (the caller is responsible for freeing this memory with the