original/man3/wcscasecmp.3

   1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
   2 .\"
   3 .\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
   4 .\" This is free documentation; you can redistribute it and/or
   5 .\" modify it under the terms of the GNU General Public License as
   6 .\" published by the Free Software Foundation; either version 2 of
   7 .\" the License, or (at your option) any later version.
   8 .\" %%%LICENSE_END
   9 .\"
  10 .\" References consulted:
  11 .\"   GNU glibc-2 source code and manual
  12 .\"   Dinkumware C library reference http://www.dinkumware.com/
  13 .\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
  14 .\"
  15 .TH WCSCASECMP 3 2014-01-22 "GNU" "Linux Programmer's Manual"
  16 .SH NAME
  17 wcscasecmp \- compare two wide-character strings, ignoring case
  18 .SH SYNOPSIS
  19 .nf
  20 .B #include <wchar.h>
  21 .sp
  22 .BI "int wcscasecmp(const wchar_t *" s1 ", const wchar_t *" s2 );
  23 .fi
  24 .sp
  25 .in -4n
  26 Feature Test Macro Requirements for glibc (see
  27 .BR feature_test_macros (7)):
  28 .in
  29 .sp
  30 .BR wcscasecmp ():
  31 .PD 0
  32 .ad l
  33 .RS 4
  34 .TP 4
  35 Since glibc 2.10:
  36 _XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L
  37 .TP
  38 Before glibc 2.10:
  39 _GNU_SOURCE
  40 .RE
  41 .ad
  42 .PD
  43 .SH DESCRIPTION
  44 The
  45 .BR wcscasecmp ()
  46 function is the wide-character equivalent of the
  47 .BR strcasecmp (3)
  48 function.
  49 It compares the wide-character string pointed to
  50 by
  51 .I s1
  52 and the wide-character string pointed to by
  53 .IR s2 ,
  54 ignoring
  55 case differences
  56 .RB ( towupper (3),
  57 .BR towlower (3)).
  58 .SH RETURN VALUE
  59 The
  60 .BR wcscasecmp ()
  61 function returns zero if the wide-character strings at
  62 .I s1
  63 and
  64 .I s2
  65 are equal except for case distinctions.
  66 It returns a
  67 positive integer if
  68 .I s1
  69 is greater than
  70 .IR s2 ,
  71 ignoring case.
  72 It
  73 returns a negative integer if
  74 .I s1
  75 is smaller
  76 than
  77 .IR s2 ,
  78 ignoring case.
  79 .SH VERSIONS
  80 The
  81 .BR wcscasecmp ()
  82 function is provided in glibc since version 2.1.
  83 .SH ATTRIBUTES
  84 .SS Multithreading (see pthreads(7))
  85 The
  86 .BR wcscasecmp ()
  87 function is thread-safe with exceptions.
  88 It can be safely used in multithreaded applications, as long as
  89 .BR setlocale (3)
  90 is not called to change the locale during its execution.
  91 .SH CONFORMING TO
  92 POSIX.1-2008.
  93 This function is not specified in POSIX.1-2001,
  94 and is not widely available on other systems.
  95 .SH NOTES
  96 The behavior of
  97 .BR wcscasecmp ()
  98 depends on the
  99 .B LC_CTYPE
 100 category of the
 101 current locale.
 102 .SH SEE ALSO
 103 .BR strcasecmp (3),
 104 .BR wcscmp (3)
 105 .SH COLOPHON
 106 This page is part of release 3.65 of the Linux
 107 .I man-pages
 108 project.
 109 A description of the project,
 110 and information about reporting bugs,
 111 can be found at
 112 \%http://www.kernel.org/doc/man\-pages/.