man3/wcsncasecmp.3

   1 '\" t
   2 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
   3 .\"
   4 .\" SPDX-License-Identifier: GPL-2.0-or-later
   5 .\"
   6 .\" References consulted:
   7 .\"   GNU glibc-2 source code and manual
   8 .\"   Dinkumware C library reference http://www.dinkumware.com/
   9 .\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
  10 .\"
  11 .TH wcsncasecmp 3 (date) "Linux man-pages (unreleased)"
  12 .SH NAME
  13 wcsncasecmp \- compare two fixed-size wide-character strings, ignoring case
  14 .SH LIBRARY
  15 Standard C library
  16 .RI ( libc ", " \-lc )
  17 .SH SYNOPSIS
  18 .nf
  19 .B #include <wchar.h>
  20 .P
  21 .BI "int wcsncasecmp(const wchar_t " s1 [. n "], const wchar_t " s2 [. n "], s\
  22 ize_t " n );
  23 .fi
  24 .P
  25 .RS -4
  26 Feature Test Macro Requirements for glibc (see
  27 .BR feature_test_macros (7)):
  28 .RE
  29 .P
  30 .BR wcsncasecmp ():
  31 .nf
  32     Since glibc 2.10:
  33         _POSIX_C_SOURCE >= 200809L
  34     Before glibc 2.10:
  35         _GNU_SOURCE
  36 .fi
  37 .SH DESCRIPTION
  38 The
  39 .BR wcsncasecmp ()
  40 function is the wide-character equivalent of the
  41 .BR strncasecmp (3)
  42 function.
  43 It compares the wide-character string pointed to
  44 by
  45 .I s1
  46 and the wide-character string
  47 pointed to by
  48 .IR s2 ,
  49 but at most
  50 .I n
  51 wide characters from each string, ignoring case differences
  52 .RB ( towupper (3),
  53 .BR towlower (3)).
  54 .SH RETURN VALUE
  55 The
  56 .BR wcsncasecmp ()
  57 function returns zero
  58 if the wide-character strings at
  59 .I s1
  60 and
  61 .IR s2 ,
  62 truncated to at most length
  63 .IR n ,
  64 are equal except
  65 for case distinctions.
  66 It returns a positive integer if truncated
  67 .I s1
  68 is
  69 greater than truncated
  70 .IR s2 ,
  71 ignoring case.
  72 It returns a negative integer
  73 if truncated
  74 .I s1
  75 is smaller than truncated
  76 .IR s2 ,
  77 ignoring case.
  78 .SH ATTRIBUTES
  79 For an explanation of the terms used in this section, see
  80 .BR attributes (7).
  81 .TS
  82 allbox;
  83 lbx lb lb
  84 l l l.
  85 Interface       Attribute       Value
  86 T{
  87 .na
  88 .nh
  89 .BR wcsncasecmp ()
  90 T}      Thread safety   MT-Safe locale
  91 .TE
  92 .SH STANDARDS
  93 POSIX.1-2008.
  94 .SH HISTORY
  95 glibc 2.1.
  96 .SH NOTES
  97 The behavior of
  98 .BR wcsncasecmp ()
  99 depends on the
 100 .B LC_CTYPE
 101 category of the
 102 current locale.
 103 .SH SEE ALSO
 104 .BR strncasecmp (3),
 105 .BR wcsncmp (3)