wcsncasecmp(3)

1wcsncasecmp(3)             Library Functions Manual             wcsncasecmp(3)
2
3
4

NAME

6       wcsncasecmp  -  compare two fixed-size wide-character strings, ignoring
7       case
8

LIBRARY

10       Standard C library (libc, -lc)
11

SYNOPSIS

13       #include <wchar.h>
14
15       int wcsncasecmp(const wchar_t s1[.n], const wchar_t s2[.n], size_t n);
16
17   Feature Test Macro Requirements for glibc (see feature_test_macros(7)):
18
19       wcsncasecmp():
20           Since glibc 2.10:
21               _POSIX_C_SOURCE >= 200809L
22           Before glibc 2.10:
23               _GNU_SOURCE
24

DESCRIPTION

26       The wcsncasecmp() function is  the  wide-character  equivalent  of  the
27       strncasecmp(3) function.  It compares the wide-character string pointed
28       to by s1 and the wide-character string pointed to by s2, but at most  n
29       wide  characters  from  each  string, ignoring case differences (towup‐
30       per(3), towlower(3)).
31

RETURN VALUE

33       The wcsncasecmp() function returns zero if the  wide-character  strings
34       at  s1 and s2, truncated to at most length n, are equal except for case
35       distinctions.  It returns a positive integer if truncated s1 is greater
36       than  truncated  s2,  ignoring  case.  It returns a negative integer if
37       truncated s1 is smaller than truncated s2, ignoring case.
38

ATTRIBUTES

40       For an  explanation  of  the  terms  used  in  this  section,  see  at‐
41       tributes(7).
42
43       ┌─────────────────────────────────────┬───────────────┬────────────────┐
44       │Interface                            │ Attribute     │ Value          │
45       ├─────────────────────────────────────┼───────────────┼────────────────┤
46       │wcsncasecmp()                        │ Thread safety │ MT-Safe locale │
47       └─────────────────────────────────────┴───────────────┴────────────────┘
48

STANDARDS

50       POSIX.1-2008.
51

HISTORY

53       glibc 2.1.
54

NOTES

56       The  behavior  of wcsncasecmp() depends on the LC_CTYPE category of the
57       current locale.
58