Cygwin: mmap: allow remapping part of an existing anonymous mapping
[newlib-cygwin.git] / newlib / libc / string / wcsncasecmp.c
blobb77952ac327bcfa607eadf3555b53ef32fb5479c
1 /*
2 FUNCTION
3 <<wcsncasecmp>>---case-insensitive wide character string compare
5 INDEX
6 wcsncasecmp
8 SYNOPSIS
9 #include <wchar.h>
10 int wcsncasecmp(const wchar_t *<[a]>, const wchar_t * <[b]>, size_t <[length]>);
12 DESCRIPTION
13 <<wcsncasecmp>> compares up to <[length]> wide characters
14 from the string at <[a]> to the string at <[b]> in a
15 case-insensitive manner.
17 RETURNS
19 If <<*<[a]>>> sorts lexicographically after <<*<[b]>>> (after
20 both are converted to uppercase), <<wcsncasecmp>> returns a
21 number greater than zero. If the two strings are equivalent,
22 <<wcsncasecmp>> returns zero. If <<*<[a]>>> sorts
23 lexicographically before <<*<[b]>>>, <<wcsncasecmp>> returns a
24 number less than zero.
26 PORTABILITY
27 POSIX-1.2008
29 <<wcsncasecmp>> requires no supporting OS subroutines. It uses
30 tolower() from elsewhere in this library.
32 QUICKREF
33 wcsncasecmp
36 #include <wchar.h>
37 #include <wctype.h>
39 int
40 wcsncasecmp (const wchar_t *s1,
41 const wchar_t *s2,
42 size_t n)
44 int d = 0;
45 for ( ; n != 0; n--)
47 const int c1 = towlower (*s1++);
48 const int c2 = towlower (*s2++);
49 if (((d = c1 - c2) != 0) || (c2 == '\0'))
50 break;
52 return d;