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)