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)