draft/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 .\"O .SH NAME
  23 .SH 名前
  24 .\"O getwchar \- read a wide character from standard input
  25 getwchar \- 標準入力よりワイド文字を読み込む
  26 .\"O .SH SYNOPSIS
  27 .SH 書式
  28 .nf
  29 .B #include <wchar.h>
  30 .sp
  31 .B "wint_t getwchar(void);"
  32 .fi
  33 .\"O .SH DESCRIPTION
  34 .SH 説明
  35 .\"O The
  36 .\"O .BR getwchar ()
  37 .\"O function is the wide-character equivalent of the
  38 .\"O .BR getchar (3)
  39 .\"O function.
  40 .\"O It reads a wide character from \fIstdin\fP and returns
  41 .\"O it.
  42 .\"O If the end of stream is reached, or if \fIferror(stdin)\fP becomes
  43 .\"O true, it returns
  44 .\"O .BR WEOF .
  45 .\"O If a wide character conversion error occurs, it sets
  46 .\"O \fIerrno\fP to \fBEILSEQ\fP and returns
  47 .\"O .BR WEOF .
  48 .BR getwchar ()
  49 関数は
  50 .BR getchar (3)
  51 関数のワイド文字版である。
  52 \fBstdin\fP からワイド文字を読み込んでそれを返す。
  53 ストリームの最後に達している場合や \fIferror(stdin)\fP が真の場合には
  54 .B WEOF
  55 を返す。ワイド文字変換でエラーが起こった場合には \fIerrno\fP に
  56 \fBEILSEQ\fP を設定して
  57 .B WEOF
  58 を返す。
  59 .PP
  60 .\"O For nonlocking counterparts, see
  61 .\"O .BR unlocked_stdio (3).
  62 これらの処理をロックせずに行いたいときは、
  63 .BR unlocked_stdio (3)
  64 を参照のこと。
  65 .\"O .SH "RETURN VALUE"
  66 .SH 返り値
  67 .\"O The
  68 .\"O .BR getwchar ()
  69 .\"O function returns the next wide-character from
  70 .\"O standard input, or
  71 .\"O .BR WEOF .
  72 .BR getwchar ()
  73 関数は標準入力の次のワイド文字を返すか、
  74 .B WEOF
  75 を返す。
  76 .\"O .SH "CONFORMING TO"
  77 .SH 準拠
  78 C99.
  79 .\"O .SH NOTES
  80 .SH 注意
  81 .\"O The behavior of
  82 .\"O .BR getwchar ()
  83 .\"O depends on the
  84 .\"O .B LC_CTYPE
  85 .\"O category of the
  86 .\"O current locale.
  87 .BR getwchar ()
  88 の動作は現在のロケールの
  89 .B LC_CTYPE
  90 カテゴリに依存している。
  91 .PP
  92 .\"O It is reasonable to expect that
  93 .\"O .BR getwchar ()
  94 .\"O will actually read a multibyte
  95 .\"O sequence from standard input and then convert it to a wide character.
  96 .BR getwchar ()
  97 が実際には標準入力からマルチバイト列を読み込んで
  98 ワイド文字に変換することを期待しても良い。
  99 .\"O .SH "SEE ALSO"
 100 .SH 関連項目
 101 .BR fgetwc (3),
 102 .BR unlocked_stdio (3)