man3/wcsncasecmp.3

   1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
   2 .\"
   3 .\" This is free documentation; you can redistribute it and/or
   4 .\" modify it under the terms of the GNU General Public License as
   5 .\" published by the Free Software Foundation; either version 2 of
   6 .\" the License, or (at your option) any later version.
   7 .\"
   8 .\" References consulted:
   9 .\"   GNU glibc-2 source code and manual
  10 .\"   Dinkumware C library reference http://www.dinkumware.com/
  11 .\"   OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
  12 .\"
  13 .TH WCSNCASECMP 3  1999-07-25 "GNU" "Linux Programmer's Manual"
  14 .SH NAME
  15 wcsncasecmp \- compare two fixed-size wide-character strings, ignoring case
  16 .SH SYNOPSIS
  17 .nf
  18 .B #include <wchar.h>
  19 .sp
  20 .BI "int wcsncasecmp(const wchar_t *" s1 ", const wchar_t *" s2 ", size_t " n );
  21 .fi
  22 .SH DESCRIPTION
  23 The \fBwcsncasecmp\fP function is the wide-character equivalent of the
  24 \fBstrncasecmp\fP function. It compares the wide-character string pointed to
  25 by \fIs1\fP and the wide-character string pointed to by \fIs2\fP, but at most
  26 \fIn\fP wide characters from each string, ignoring case differences
  27 (\fBtowupper\fP, \fBtowlower\fP).
  28 .SH "RETURN VALUE"
  29 The \fBwcsncasecmp\fP function returns zero if the wide-character strings at
  30 \fIs1\fP and \fIs2\fP, truncated to at most length \fIn\fP, are equal except
  31 for case distinctions. It returns a positive integer if truncated \fIs1\fP is
  32 greater than truncated \fIs2\fP, ignoring case. It returns a negative integer
  33 if truncated \fIs1\fP is smaller than truncated \fIs2\fP, ignoring case.
  34 .SH "CONFORMING TO"
  35 This function is a GNU extension.
  36 .SH "SEE ALSO"
  37 .BR strncasecmp (3),
  38 .BR wcsncmp (3)
  39 .SH NOTES
  40 The behaviour of \fBwcsncasecmp\fP depends on the LC_CTYPE category of the
  41 current locale.