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
  24 .BR wcsncasecmp ()
  25 function is the wide-character equivalent of the
  26 .BR strncasecmp (3)
  27 function.
  28 It compares the wide-character string pointed to
  29 by \fIs1\fP and the wide-character string
  30 pointed to by \fIs2\fP, but at most
  31 \fIn\fP wide characters from each string, ignoring case differences
  32 .RB ( towupper (3),
  33 .BR towlower (3)).
  34 .SH "RETURN VALUE"
  35 The
  36 .BR wcsncasecmp ()
  37 function returns zero
  38 if the wide-character strings at
  39 \fIs1\fP and \fIs2\fP,
  40 truncated to at most length \fIn\fP, are equal except
  41 for case distinctions.
  42 It returns a positive integer if truncated \fIs1\fP is
  43 greater than truncated \fIs2\fP, ignoring case.
  44 It returns a negative integer
  45 if truncated \fIs1\fP is smaller than truncated \fIs2\fP, ignoring case.
  46 .SH "CONFORMING TO"
  47 This function is a GNU extension.
  48 .SH NOTES
  49 The behaviour of
  50 .BR wcsncasecmp ()
  51 depends on the LC_CTYPE category of the
  52 current locale.
  53 .SH "SEE ALSO"
  54 .BR strncasecmp (3),
  55 .BR wcsncmp (3)