Single-Element Functions : List of Functions : stm_r_xx_uniquename

stm_r_xx_uniquename
Returns the unique path name for the specified element. The name returned by the function contains the minimum number of levels necessary to uniquely identify an element in its chart. It is especially relevant to boxes.
You can call this function without indicating the specific element type:

stm_r_uniquename (id, &status)

Function Type
har *
For Elements
Syntax
stm_r_xx_uniquename (xx_id, &status)
Arguments
Input/Output
Status Codes
Example
Consider the following statechart:
To retrieve the unique name of the highlighted state, use the following statements:

 

stm_id state_id;
int status;
.
.
state_id = stm_r_st ("S1.S3", &status);
printf ("Unique Name:%s", stm_r_st_uniquename (
state_id, &status));
.
.
.

The state name printed is S1.S3 (not S.S1.S3 or S3). In this example, a unique state name is provided, and this value is used to retrieve the same unique state name from the database. This example demonstrates the value returned by this function, in contrast to the value returned by the function stm_r_xx_name.