stm_r_xx_nameReturns the element name. For hierarchical elements, the function returns the name associated with the box. Because hierarchical elements can share the same name, the return value does not necessarily uniquely identify an element. To return a unique name, use the functionstm_r_xx_uniquename
.
● This function returns a pointer to a static area of memory. Subsequent calls to this procedure overwrite the old string. If the name needs to be preserved, use thestrdup()
function from the string library.
● For boxes that have no names, this function returns the definition chart name. For example, for box@ABC
, this function returnsABC
.
Input/Output
stm_id state_id;
int status;
.
.
state_id = stm_r_st ("S1.S3", &status);
printf ("%s", stm_r_st_name (state_id, &status));
.
.In this example, the state name is provided and this value is used to retrieve the same state name from the database. The purpose of this example is to demonstrate the value returned by this function, in contrast to the value returned by the functionstm_r_xx_uniquename
.