SOM Kernel Reference 1-27
somRegisterId Function
Purpose
Registers a SOM ID and determines whether or not it was previously registered.
Syntax
int somRegisterId (somId id);
Description
The somRegisterId function registers a SOM ID and converts it into an internal
representation. If the ID is already registered, somRegisterId returns 0 and has no effect.
Otherwise, somRegisterId returns 1.
Parameters
id The somId to be registered.
Return Value
If the ID is already registered, somRegisterId returns 0. Otherwise, somRegisterId returns
1.
C Example
#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 Information
Functions: somCheckId, somIdFromString, somStringFromId, somCompareIds,
somTotalRegIds, somSetExpectedIds, somUniqueKey, somBeginPersistentIds,
somEndPersistentIds
Data Structures: somId (sombtype.h)
Kommentare zu diesen Handbüchern