Syntax

   #include <unicode.h> 
    
   N_EXTERN_LIBRARY(nint) uniicmp  ( 
      const unicode N_FAR  *s1,  
      const unicode N_FAR  *s2);
   

Pascal Syntax

   uses netwin32 
    
   Function uniicmp 
     (s1 : const unicode;          
      s2 : const unicode          
   ) : nint;
   

Parameters

s1

(IN) Points to the first string to be compared.

s2

(IN) Points to the second string to be compared.

Return Values

One of the following int values:

< 0 if s1 is less than s2

= 0 if s1 is equal to s2

> 0 if s1 is greater than s2

Remarks

uniicmp converts its arguments to lower case according to the standard Monocase Converter rules. It then compares s1 to s2, starting with the first character in each string and continuing with subsequent characters until (1) the corresponding characters differ, or (2) the end of the strings is reached. The comparison is done lexicographically, using the value of the unicode character, not the collation weight.

uniicmp is useful for comparing strings for equality. Do not call uniicmp for sorting strings into collation order.

uniicmp corresponds to the C stricmp function.

For sample code, see Section 3.16, Example: uniicmp.