Utility Functions : List of Utility Functions : stm_list_sort_by_name

stm_list_sort_by_name
Sorts the specified list of Rational Statemate elements alphabetically by name.
Note:  
The function returns the status code stm_elements_without_name when you attempt to apply this function to a list that contains unnamed elements.
Function Type
stm_list
Syntax
stm_list_sort_by_name (list, &status)
Arguments
Input/Output
The list of Statemate elements to be sorted. This input lists consists of element IDs.
Status Codes
Example
To sort a list of items by name, use the following statements:

stm_list st_list, sorted_st_list;
int status;
.
.
st_list = stm_r_st_name_of_st ("*", &status);
sorted_st_list = stm_list_sort_by_name (st_list,
&status);
.
.

A list of all named states in an unspecified order is retrieved from the database, then the sort function orders the list.