draft/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 .\"O .SH NAME
  22 .SH 名前
  23 .\"O fputwc, putwc \- write a wide character to a FILE stream
  24 fputwc, putwc \- ワイド文字を FILE ストリームに書き込む
  25 .\"O .SH SYNOPSIS
  26 .SH 書式
  27 .nf
  28 .B #include <stdio.h>
  29 .br
  30 .B #include <wchar.h>
  31 .sp
  32 .BI "wint_t fputwc(wchar_t " wc ", FILE *" stream );
  33 .BI "wint_t putwc(wchar_t " wc ", FILE *" stream );
  34 .fi
  35 .\"O .SH DESCRIPTION
  36 .SH 説明
  37 .\"O The
  38 .\"O .BR fputwc ()
  39 .\"O function is the wide-character
  40 .\"O equivalent of the
  41 .\"O .BR fputc (3)
  42 .\"O function.
  43 .\"O It writes the wide character \fIwc\fP to \fIstream\fP.
  44 .\"O If
  45 .\"O \fIferror(stream)\fP becomes true, it returns
  46 .\"O .BR WEOF .
  47 .\"O If a wide character conversion error occurs,
  48 .\"O it sets \fIerrno\fP to \fBEILSEQ\fP and returns
  49 .\"O .BR WEOF .
  50 .\"O Otherwise it returns \fIwc\fP.
  51 .BR fputwc ()
  52 関数は、
  53 .BR fputc (3)
  54 に対応するワイド文字関数である。この
  55 関数は、ワイド文字 \fIwc\fP を \fIstream\fP に書き込む。
  56 \fIferror(stream)\fP が真になると、この関数は
  57 .B WEOF
  58 を返す。
  59 ワイド文字変換でエラーが発生した場合は、
  60 \fIerrno\fP に \fBEILSEQ\fP をセットし、
  61 .B WEOF
  62 を返す。
  63 それ以外の場合では、この関数は \fIwc\fP を返す。
  64 .PP
  65 .\"O The
  66 .\"O .BR putwc ()
  67 .\"O function or macro functions identically to
  68 .\"O .BR fputwc ().
  69 .\"O It may be implemented as a macro, and may evaluate its argument
  70 .\"O more than once.
  71 .\"O There is no reason ever to use it.
  72 .BR putwc ()
  73 関数あるいはマクロは、
  74 .BR fputwc ()
  75 と全く同じ動作をする。
  76 この関数はマクロとして実装されるかもしれないので、引き数が複数回評価さ
  77 れるかもしれない。この関数を使う理由はもはや存在しない。
  78 .PP
  79 .\"O For nonlocking counterparts, see
  80 .\"O .BR unlocked_stdio (3).
  81 これらの処理を停止せずに行いたいときは、
  82 .BR unlocked_stdio (3)
  83 を参照のこと。
  84 .\"O .SH "RETURN VALUE"
  85 .SH 返り値
  86 .\"O The
  87 .\"O .BR fputwc ()
  88 .\"O function returns \fIwc\fP if no error occurred, or
  89 .\"O .B WEOF
  90 .\"O to indicate an error.
  91 .BR fputwc ()
  92 関数は、エラーが起きなければ \fIwc\fP を返す。エラーの場合には
  93 .B WEOF
  94 を返す。
  95 .\"O .SH ERRORS
  96 .SH エラー
  97 .\"O Apart from the usual ones, there is
  98 普通のものの他に、以下のものがある。
  99 .TP
 100 .B EILSEQ
 101 .\"O Conversion of \fIwc\fP to the stream's encoding fails.
 102 \fIwc\fP からストリームの符号への変換に失敗した。
 103 .\"O .SH "CONFORMING TO"
 104 .SH 準拠
 105 C99, POSIX.1-2001.
 106 .\"O .SH NOTES
 107 .SH 注意
 108 .\"O The behavior of
 109 .\"O .BR fputwc ()
 110 .\"O depends on the
 111 .\"O .B LC_CTYPE
 112 .\"O category of the
 113 .\"O current locale.
 114 .BR fputwc ()
 115 の動作は現在のロケールの
 116 .B LC_CTYPE
 117 カテゴリに依存する。
 118 .PP
 119 .\"O In the absence of additional information passed to the
 120 .\"O .BR fopen (3)
 121 .\"O call, it is
 122 .\"O reasonable to expect that
 123 .\"O .BR fputwc ()
 124 .\"O will actually write the multibyte
 125 .\"O sequence corresponding to the wide character \fIwc\fP.
 126 .BR fopen (3)
 127 システムコールに渡す追加情報がない場合には、
 128 .BR fputwc ()
 129 は
 130 実際にはワイド文字 \fIwc\fP に対応するマルチバイトシーケンスを書き込むと
 131 期待してよい。
 132 .\"O .SH "SEE ALSO"
 133 .SH 関連項目
 134 .BR fgetwc (3),
 135 .BR fputws (3),
 136 .BR unlocked_stdio (3)