SomRegisterId: Difference between revisions
Created page with "This function registers a SOM ID and determines whether or not it was previously registered. ==Syntax== <PRE> somId id; int rc; rc = somRegisterId(id); </PRE> ==Par..." |
No edit summary |
||
| Line 1: | Line 1: | ||
{{DISPLAYTITLE:somRegisterId}} | |||
This function registers a SOM ID and determines whether or not it was previously registered. | This function registers a SOM ID and determines whether or not it was previously registered. | ||
| Line 38: | Line 39: | ||
* somId (sombtype.h). | * somId (sombtype.h). | ||
===Functions=== | ===Functions=== | ||
* somCheckId | * [[somCheckId]] | ||
* somIdFromString | * [[somIdFromString]] | ||
* somStringFromId | * [[somStringFromId]] | ||
* somCompareIds | * [[somCompareIds]] | ||
* somTotalRegIds | * [[somTotalRegIds]] | ||
* somSetExpectedIds | * [[somSetExpectedIds]] | ||
* somUniqueKey | * [[somUniqueKey]] | ||
* somBeginPersistentIds | * [[somBeginPersistentIds]] | ||
* somEndPersistentIds | * [[somEndPersistentIds]] | ||
[[Category:SOM Kernel]] | [[Category:SOM Kernel]] | ||
Revision as of 20:16, 12 October 2017
This function registers a SOM ID and determines whether or not it was previously registered.
Syntax
somId id; int rc; rc = somRegisterId(id);
Parameters
- id (somId)
Return Code
- rc (int)
0 Returns 0 if the ID is already registered. 1 Returns 1 if the ID is not already registered
Remarks
This function registers a SOM ID and converts it into an internal representation. If the ID is already registered, this function returns 0 and has no effect. Otherwise, this function returns 1.
Example Code
#include <som.h>
static string s = "unregistered";
static somId sid = &s;
main()
{
somEnvironmentNew();
SOM_Test(somRegisterId(sid) == 1);
SOM_Test(somRegisterId(somIdFromString("registered")) == 0);
}
Related
Data Structures
- somId (sombtype.h).