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