draft/man3/wcsncmp.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 .\"   ISO/IEC 9899:1999
  13 .\"
  14 .\"*******************************************************************
  15 .\"
  16 .\" This file was generated with po4a. Translate the source file.
  17 .\"
  18 .\"*******************************************************************
  19 .TH WCSNCMP 3 2011\-09\-28 GNU "Linux Programmer's Manual"
  20 .SH 名前
  21 wcsncmp \- 2 つの固定長ワイド文字文字列を比較する
  22 .SH 書式
  23 .nf
  24 \fB#include <wchar.h>\fP
  25 .sp
  26 \fBint wcsncmp(const wchar_t *\fP\fIs1\fP\fB, const wchar_t *\fP\fIs2\fP\fB, size_t \fP\fIn\fP\fB);\fP
  27 .fi
  28 .SH 説明
  29 \fBwcsncmp\fP()  関数は、 \fBstrncmp\fP(3)  関数に対応するワイド文字関数である。 この関数は、\fIs1\fP
  30 が指すワイド文字文字列と \fIs2\fP が指すワイド文 字文字列を比較するが、最大でも先頭のワイド文字 \fIn\fP 個までしか比較
  31 しない。またいずれかの文字列に NULL ワイド文字 (L\(aq\e0\(aq) が現れたら、 比較はその位置で終了する。
  32 .SH 返り値
  33 \fBwcsncmp\fP()  関数は、\fIs1\fP と \fIs2\fP がそれぞれ指す文字列を \fIn\fP 文字に収まるように切り詰めたものが等しければ 0
  34 を返す。 この関数は、異なる文字が最初に現われた位置 \fIi\fP (\fIi\fP < \fIn\fP)  において、その位置にある文字 \fIs1[i]\fP が
  35 \fIs2[i]\fP より大きければ 正の値を返す。異なる文字が最初に現われた位置 \fIi\fP (\fIi\fP < \fIn\fP)
  36 において、その位置にある文字 \fIs1[i]\fP が \fIs2[i]\fP より小さければ 負の値を返す。
  37 .SH 準拠
  38 C99.
  39 .SH 関連項目
  40 \fBstrncmp\fP(3), \fBwcsncasecmp\fP(3)