View source for SomTotalRegIds

{{DISPLAYTITLE:somTotalRegIds}}
This function returns the total number of SOM IDs that have been registered.

==Syntax==
<PRE>
unsigned long    rc;

rc = somTotalRegIds();
</PRE>

==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==
<PRE>
#include <som.h>
main()
{ int i;
  somId id;
  somEnvironmentNew();
  id = somIdFromString("abc")
  i = somTotalRegIds();
  id = somIdFromString("abc");
  SOM_Test(i == somTotalRegIds);
}
</PRE>

==Related==
===Functions===
* [[somCheckId]]
* [[somRegisterId]]
* [[somIdFromString]]
* [[somStringFromId]] 
* [[somCompareIds]]
* [[somSetExpectedIds]] 
* [[somUniqueKey]]
* [[somBeginPersistentIds]]
* [[somEndPersistentIds]]

[[Category:SOM Kernel]]