wcsnicmp

Compares, with case insensitivity, a specified number of characters in one string to another string.

Library:LibC
Classification:Other
Service:Characters and Strings

Syntax

  #include <wchar.h> 
   
  int  wcsnicmp (
     const wchar_t   *ws1,
     const wchar_t   *ws2,
     size_t           len);
  

Parameters

ws1

(IN) Points to a string to compare.

ws2

(IN) Points to a string to compare.

len

(IN) Specifies the number of characters to compare.

Return Values

Returns 0 if the two strings match, for the specified number of characters. Otherwise, it returns a positive integer if ws1 is greater than ws2 and a negative integer if ws1 is less than ws2.

Remarks

The wcsnicmp function compares, with case insensitivity, the string pointed to by ws1 to the string pointed to by ws2, for at most len characters.

See Also