somCompareIds

From EDM2
Jump to: navigation, search

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