somTotalRegIds

From EDM2
Jump to: navigation, search

This function returns the total number of SOM IDs that have been registered.

Syntax

unsigned long    rc;

rc = somTotalRegIds();

Parameters

Return Code

rc (unsigned long)
Returns the total number of SOM IDs that have been registered.

Remarks

This function returns the total number of SOM IDs that have been registered so far. This value can be used as a parameter to the somSetExpectedIds function to advise SOM about expected ID usage in later executions of a client program.

Example Code

#include <som.h>
main()
{ int i;
  somId id;
  somEnvironmentNew();
  id = somIdFromString("abc")
  i = somTotalRegIds();
  id = somIdFromString("abc");
  SOM_Test(i == somTotalRegIds);
}

Related

Functions