release/man3/getwchar.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
  12 .\"      http://www.UNIX-systems.org/online.html
  13 .\"   ISO/IEC 9899:1999
  14 .\"
  15 .\" Japanese Version Copyright (c) 1999 HANATAKA Shinya
  16 .\"         all rights reserved.
  17 .\" Translated Tue Jan 11 00:56:29 JST 2000
  18 .\"         by HANATAKA Shinya <hanataka@abyss.rim.or.jp>
  19 .\" Updated Sat Nov  3 JST 2001 by Kentaro Shirakata <argrath@ub32.org>
  20 .\"
  21 .TH GETWCHAR 3  1999-07-25 "GNU" "Linux Programmer's Manual"
  22 .SH 名前
  23 getwchar \- 標準入力よりワイド文字を読み込む
  24 .SH 書式
  25 .nf
  26 .B #include <wchar.h>
  27 .sp
  28 .B "wint_t getwchar(void);"
  29 .fi
  30 .SH 説明
  31 .BR getwchar ()
  32 関数は
  33 .BR getchar (3)
  34 関数のワイド文字版である。
  35 \fBstdin\fP からワイド文字を読み込んでそれを返す。
  36 ストリームの最後に達している場合や \fIferror(stdin)\fP が真の場合には
  37 .B WEOF
  38 を返す。ワイド文字変換でエラーが起こった場合には \fIerrno\fP に
  39 \fBEILSEQ\fP を設定して
  40 .B WEOF
  41 を返す。
  42 .PP
  43 これらの処理をロックせずに行いたいときは、
  44 .BR unlocked_stdio (3)
  45 を参照のこと。
  46 .SH 返り値
  47 .BR getwchar ()
  48 関数は標準入力の次のワイド文字を返すか、
  49 .B WEOF
  50 を返す。
  51 .SH 準拠
  52 C99.
  53 .SH 注意
  54 .BR getwchar ()
  55 の動作は現在のロケールの
  56 .B LC_CTYPE
  57 カテゴリに依存している。
  58 .PP
  59 .BR getwchar ()
  60 が実際には標準入力からマルチバイト列を読み込んで
  61 ワイド文字に変換することを期待しても良い。
  62 .SH 関連項目
  63 .BR fgetwc (3),
  64 .BR unlocked_stdio (3)