release/man3/putwchar.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:55:58 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 PUTWCHAR 3  1999-07-25 "GNU" "Linux Programmer's Manual"
  22 .SH 名前
  23 putwchar \- ワイド文字を標準出力へ書き出す
  24 .SH 書式
  25 .nf
  26 .B #include <wchar.h>
  27 .sp
  28 .BI "wint_t putwchar(wchar_t " wc );
  29 .fi
  30 .SH 説明
  31 .BR putwchar ()
  32 関数は
  33 .BR putchar ()
  34 のワイド文字版である。
  35 この関数は \fIwc\fP を \fIstdout\fP へと書き出す。\fIferror(stdout)\fP が
  36 真ならば
  37 .B WEOF
  38 を返す。ワイド文字の変換に失敗した場合には \fIerrno\fP に
  39 \fBEILSEQ\fP を設定して
  40 .B WEOF
  41 を返す。それ以外の場合は \fIwc\fP を返す。
  42 .PP
  43 これらの処理をロックせずに行いたいときは、
  44 .BR unlocked_stdio (3)
  45 を参照のこと。
  46 .SH 返り値
  47 エラーが起きなかった場合、
  48 .BR putwchar ()
  49 関数は \fIwc\fP を返す。
  50 エラーが起きた場合は
  51 .B WEOF
  52 を返す。
  53 .SH 準拠
  54 C99.
  55 .SH 注意
  56 .BR putwchar ()
  57 の動作は現在のロケールの
  58 .B LC_CTYPE
  59 カテゴリに依存している。
  60 .PP
  61 .BR putwchar ()
  62 が実際にはワイド文字 \fIwc\fP と等価なマルチバイト文字を
  63 書き出すことを期待してもよい。
  64 .SH 関連項目
  65 .BR fputwc (3),
  66 .BR unlocked_stdio (3)