Utility Functions : List of Utility Functions : stm_list_next_id_element

stm_list_next_id_element
Function Type
stm_list_id_elm
Description
Returns the next item appearing in the list passed as an input argument. This function can be applied to lists containing stm_list_id_elm’s..
Syntax
stm_list_next_id_element (list, &status)
Arguments
Input/Output
 
Status Codes
Example
To find the next element in the list of states, S1, S2, S3, and S4 (appearing in this order) assigned to the variable state_list, use the following statements:

 

stm_list state_list;
stm_id state_id;
int status;
.
.
state_id = (stm_id) stm_list_first_id_element (
state_list, &status);
printf ("The first state in the list is: %s\n",
stm_r_st_name (state_id, &status));
state_id = (stm_id) stm_list_next_id_element (state_list,
&status);
printf ("The second state in the list is: %s\n",
stm_r_st_name (state_id, &status));
.
.

This function can be used in a for loop (in conjunction with stm_list_first_id_element) to perform operations on all elements in the list