C in a Nutshell

Name

wcsncmp

Synopsis

Compares the first n wide characters of two strings

#include <wchar.h>
intwcsncmp( const wchar_t *s1, const wchar_t *s2, size_t n );

The wcsncmp() function compares at most the first n wide characters in the two strings addressed by its pointer arguments. Characters that follow a null wide character are ignored. wcsncmp() returns a value indicating the result as follows:

Zero

The two wide strings, or arrays of n wide characters, are equal.

Greater than zero

The string or array of n wide characters addressed by s1 is greater than that addressed by s2.

Less than zero

The string or array of n wide characters addressed by s1 is less than that addressed by s2.

Example

wchar_t *months[ ] = { L"January", L"February", L"March", L"April",
                      L"May", L"June", L"July", L"August",
                      L"September", L"October", L"November", L"December" };

wchar_t date[ ] = L"Thu, 10 Mar 2005 13:44:18 +0100";
int mo = 0;
while (( mo < 12 ) && (wcsncmp( date + 8, months[mo], 3 ) != 0 ))
  mo++;

See Also

wcscmp(), wcscoll(), strncmp(), strcmp()