Name
wcsncmp — compare two fixed-size wide-character
strings
Synopsis
#include <wchar.h>
int
wcsncmp( |
const wchar_t * |
s1, |
| |
const wchar_t * |
s2, |
| |
size_t |
n); |
DESCRIPTION
The wcsncmp() function is
the wide-character equivalent of the strncmp(3) function. It
compares the wide-character string pointed to by s1 and the wide-character
string pointed to by s2, but at most n wide characters from each
string. In each string, the comparison extends only up to the
first occurrence of a L'\0' character, if any.
RETURN VALUE
The wcsncmp() function
returns zero if the wide-character strings at s1 and s2, truncated to at most length
n, are equal. It
returns an integer greater than zero if at the first
differing position i (i < n), the corresponding
wide-character s1[i] is greater than
s2[i]. It returns
an integer less than zero if at the first differing position
i (i < n), the corresponding
wide-character s1[i] is less than s2[i].
SEE ALSO
strncmp(3), wcsncasecmp(3)
Copyright (c) Bruno Haible <haible@clisp.cons.org>
This is free documentation; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of
the License, or (at your option) any later version.
References consulted:
GNU glibc-2 source code and manual
Dinkumware C library reference http://www.dinkumware.com/
OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
ISO/IEC 9899:1999
|
