stm_r_xxRetrieves the element ID of the specified element. This ID is an internal representation that Rational Statemate uses to identify each element in the database. Because Rational Statemate requires the ID to locate elements, this function is very often the first one called when using dataport functions.
Input/Outputstm_element_name
or stm_pathname
A Rational Statemate element name or synonym.
• This can be an element name (path name) or synonym. Hierarchical elements must be identified uniquely by specifying a unique path name.
• The name can include the chart name (for example,A:B
). Identify the ID of an eventEV1
. Once the ID has been determined, you can use it to retrieve information aboutEV1
from the database, as follows:stm_id ev_id;
int status;
stm_short_name synonym;
.
.
ev_id = stm_r_ev ("EV1", &status);
IF (status == stm_success)
synonym = stm_r_ev_synonym (ev_id, &status);
.
.
.
Note:ev_id
is declared to be of typestm_id
.