SomCompareIds

This function determines whether two SOM IDs represent the same string.

Syntax

somId    id1;
somId    id2;
int      rc;

rc = somCompareIds(id1, id2);

Parameters

id1 (somId)

The first SOM ID to be compared.

id2 (somId)

The second SOM ID to be compared.

Return Code

rc (int)

• 1 Returns 1 if the two input IDs represent strings that are equal.
• 0 Returns 0 if the two input IDs represent strings that are not equal.

Remarks

This function returns 1 if the two input IDs represent strings that are equal; otherwise, it returns 0.

Example Code

#include <som.h>
main()
{
   somId id1, id2, id3;

   somEnvironmentNew();
   id1 = somIdFromString("this");
   id2 = somIdFromString("that");
   id3 = somIdFromString("this");

   SOM_Test(somCompareIds(id1, id3));
   SOM_Test(!somCompareIds(id1, id2));
}

Related

Data Structures

• somId (sombtype.h)

Functions

• somCheckId
• somRegisterId
• somIdFromString
• somStringFromId
• somTotalRegIds
• somSetExpectedIds
• somUniqueKey
• somBeginPersistentIds
• somEndPersistentIds