original/man3/wmemcmp.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 WMEMCMP 3  1999-07-25 "GNU" "Linux Programmer's Manual"
  14 .SH NAME
  15 wmemcmp \- compare two arrays of wide-characters
  16 .SH SYNOPSIS
  17 .nf
  18 .B #include <wchar.h>
  19 .sp
  20 .BI "int wmemcmp(const wchar_t *" s1 ", const wchar_t *" s2 ", size_t " n );
  21 .fi
  22 .SH DESCRIPTION
  23 The
  24 .BR wmemcmp ()
  25 function is the wide-character equivalent of the
  26 .BR memcmp (3)
  27 function.
  28 It compares the \fIn\fP wide-characters starting at \fIs1\fP and the
  29 \fIn\fP wide-characters starting at \fIs2\fP.
  30 .SH "RETURN VALUE"
  31 The
  32 .BR wmemcmp ()
  33 function returns
  34 zero if the wide-character arrays of size
  35 \fIn\fP at \fIs1\fP and \fIs2\fP are equal.
  36 It returns an integer greater than
  37 zero if at the first differing position \fIi\fP (\fIi\fP < \fIn\fP), the
  38 corresponding wide-character \fIs1[i]\fP is greater than \fIs2[i]\fP.
  39 It returns an integer less than zero if
  40 at the first differing position \fIi\fP
  41 (\fIi\fP < \fIn\fP), the corresponding
  42 wide-character \fIs1[i]\fP is less than
  43 \fIs2[i]\fP.
  44 .SH "CONFORMING TO"
  45 C99.
  46 .SH "SEE ALSO"
  47 .BR memcmp (3),
  48 .BR wcscmp (3)