wcscasecmp(3)

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

NAME

6       wcscasecmp - compare two wide-character strings, ignoring case
7

LIBRARY

9       Standard C library (libc, -lc)
10

SYNOPSIS

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

DESCRIPTION

25       The  wcscasecmp() function is the wide-character equivalent of the str‐
26       casecmp(3) function.  It compares the wide-character string pointed  to
27       by  s1  and  the  wide-character string pointed to by s2, ignoring case
28       differences (towupper(3), towlower(3)).
29

RETURN VALUE

31       The wcscasecmp() function returns zero if the wide-character strings at
32       s1  and  s2 are equal except for case distinctions.  It returns a posi‐
33       tive integer if s1 is greater than s2, ignoring  case.   It  returns  a
34       negative integer if s1 is smaller than s2, ignoring case.
35

ATTRIBUTES

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

STANDARDS

47       POSIX.1-2008.
48

HISTORY

50       glibc 2.1.
51

NOTES

53       The behavior of wcscasecmp() depends on the LC_CTYPE  category  of  the
54       current locale.
55