release/man3/fgetwc.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 .\" Modified Tue Oct 16 23:18:40 BST 2001 by John Levon <moz@compsoc.man.ac.uk>
  16 .\" About this Japanese page, please contact to JM Project <JM@linux.or.jp>
  17 .\" Translated Sun Aug 29 15:03:27 JST 1999
  18 .\"           by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
  19 .\" Updated Sun Dec 26 JST 1999 by Kentaro Shirakata <argrath@ub32.org>
  20 .\" Updated Fri Nov  2 JST 2001 by Kentaro Shirakata <argrath@ub32.org>
  21 .\"
  22 .TH FGETWC 3 1999-07-25 "GNU" "Linux Programmer's Manual"
  23 .\") .SH NAME
  24 .SH 名前
  25 fgetwc, getwc \- ワイド文字を FILE ストリームから読み込む
  26 .SH 書式
  27 .nf
  28 .B #include <stdio.h>
  29 .br
  30 .B #include <wchar.h>
  31 .sp
  32 .BI "wint_t fgetwc(FILE *" stream );
  33 .BI "wint_t getwc(FILE *" stream );
  34 .fi
  35 .SH 説明
  36 .BR fgetwc ()
  37 関数は、
  38 .BR fgetc (3)
  39 に対応するワイド文字関数である。
  40 この関数は \fIstream\fP からワイド文字を 1 文字読み込み、これを返す。
  41 ストリームの終端に達するか、\fIferror(stream)\fP が真になった場合には、
  42 この関数は
  43 .B WEOF
  44 を返す。
  45 ワイド文字変換でエラーが発生した場合は、
  46 \fIerrno\fP に \fBEILSEQ\fP をセットし、
  47 .B WEOF
  48 を返す。
  49 .PP
  50 .BR getwc ()
  51 関数あるいはマクロは、
  52 .BR fgetwc ()
  53 と全く同じ動作をする。
  54 この関数はマクロとして実装されるかもしれないので、引き数が複数回評価さ
  55 れるかもしれない。この関数を使う理由はもはや存在しない。
  56 .PP
  57 これらの処理をロックせずに行いたいときは、
  58 .BR unlocked_stdio (3)
  59 を参照のこと。
  60 .SH 返り値
  61 .BR fgetwc ()
  62 関数はストリームの次のワイド文字か、あるいは
  63 .B WEOF
  64 を返す。
  65 .SH エラー
  66 通常のエラーに加えて、以下のエラーがある:
  67 .TP
  68 .B EILSEQ
  69 入力ストリームから取得したデータが、正しい文字でない。
  70 .SH 準拠
  71 C99, POSIX.1-2001.
  72 .SH 注意
  73 .BR fgetwc ()
  74 の動作は、現在のロケールの
  75 .B LC_CTYPE
  76 カテゴリに依存する。
  77 .PP
  78 .BR fopen (3)
  79 システムコールに渡す追加情報がない場合には、
  80 .BR fgetwc ()
  81 が実際
  82 にはマルチバイトシーケンスをストリームから読み込み、これをワイド文字に
  83 変換すると期待することは適切である。
  84 .SH 関連項目
  85 .BR fgetws (3),
  86 .BR fputwc (3),
  87 .BR ungetwc (3),
  88 .BR unlocked_stdio (3)