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, as follows:

stm_r_uniquename (id, status)

Function type
STRING
For elements
Syntax

stm_r_xx_uniquename (xx_id, status)

Arguments
 
 
Status Codes
Example
Consider the following statechart:
To retrieve the unique name of the highlighted element, use the following statements:

VARIABLE
STATE state_id;
INTEGER status;
.
.
.
state_id := stm_r_st (’S1.S3’, status);
WRITE (’\n Unique Name:’, (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.