Find state groups

saf_find_state_groups is a function defined in state.c.

Synopsis:

int saf_find_state_groups(SAF_ParMode pmode, SAF_Suite *suite, const char *name, int *num_state_grps, SAF_StateGrp **state_grps)

Formal Arguments:

  • pmode: The parallel mode.
  • suite: The suite within which to search.
  • name: The name of the state group for which to search. Pass SAF__ANY_NAME if you do not want to limit your search.
  • num_state_grps: [OUT] Returned number of state groups found.
  • state_grps: [OUT] Returned state groups found.

Description: This finds the state groups that match specified criteria.

Return Value: The constant SAF__SUCCESS is returned when this function is successful. Otherwise this function either returns an error number or throws an exception, depending on the value of the library’s error handling property.

See Also:

  • States: Introduction for current chapter