NWLstricmp

Performs a case-insensitive compare of two strings

NetWare Server:4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98
Library:Cross-Platform Localization (LOC*.*)
Service:Internationalization

Syntax

  #include <nwlocale.h> 
   
  N_EXTERN_LIBRARY(nint) NWLstricmp  ( 
     const nstr N_FAR  *str1,  
     const nstr N_FAR  *str2);

Pascal Syntax

  uses netwin32 
   
  Function NWLstricmp 
    (const str1 : pnstr; 
     const str2 : pnstr 
  ) : nint;

Parameters

str1
(IN) Points to the first string to compare.
str2
(IN) Points to the second string to compare.

Return Values

<0

If the str1 parameter is less than the str2 parameter.

=0

If the str1 parameter is identical to the str2 parameter.

>0

If the str1 parameter is greater than the str2 parameter.

Remarks

NWLstricmp compares uppercase versions of the str1 and str2 parameters and returns a value indicating their relationship.

NWLstricmp correctly handles double-byte characters.

NWLstricmp performs the comparison lexicographically using the code page value of the characters and does not use the locale sensitive collation sequence as the NWLstrcoll function. However, NWLstricmp is faster than the NWLstrcoll function and is efficient for comparing strings for equality.

See Also

NWLstrcoll, NWstrncoll