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