1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
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.
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
14 .\" Japanese Version Copyright (c) 1999 HANATAKA Shinya
15 .\" all rights reserved.
16 .\" Translated Tue Jan 11 00:55:36 JST 2000
17 .\" by HANATAKA Shinya <hanataka@abyss.rim.or.jp>
19 .TH WPRINTF 3 2007-07-26 "GNU" "Linux Programmer's Manual"
21 wprintf, fwprintf, swprintf, vwprintf, vfwprintf, vswprintf \- ¥ï¥¤¥Éʸ»ú¤ò
22 ¥Õ¥©¡¼¥Þ¥Ã¥È¤·¤Æ½ÐÎϤ¹¤ë
28 .BI "int wprintf(const wchar_t *" format ", ...);"
29 .BI "int fwprintf(FILE *" stream ", const wchar_t *" format ", ...);"
30 .BI "int swprintf(wchar_t *" wcs ", size_t " maxlen ,
31 .BI " const wchar_t *" format ", ...);"
33 .BI "int vwprintf(const wchar_t *" format ", va_list " args );
34 .BI "int vfwprintf(FILE *" stream ", const wchar_t *" format ", va_list " args );
35 .BI "int vswprintf(wchar_t *" wcs ", size_t " maxlen ,
36 .BI " const wchar_t *" format ", va_list " args );
40 glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
41 .RB ( feature_test_macros (7)
53 _XOPEN_SOURCE\ >=\ 500 || _ISOC99_SOURCE; or
61 ¥ï¥¤¥Éʸ»úÈǤǤ¢¤ë¡£¤³¤ì¤é¤Ï¥ï¥¤¥Éʸ»ú¤ò¥Õ¥©¡¼¥Þ¥Ã¥È¤·¤Æ½ÐÎϤ¹¤ë¡£
66 ´Ø¿ô¤Ï \fIstdout\fP ¤Ë½ÐÎϤò¹Ô¤Ê¤¦¡£
67 \fIstdout\fP ¤¬¥Ð¥¤¥Èñ°ÌÆþ½ÐÎϤǤ¢¤Ã¤Æ¤Ï¤¤¤±¤Ê¤¤¡£¤è¤ê¾Ü¤·¤¤ÀâÌÀ¤Ï
74 ´Ø¿ô¤Ï \fIstream\fP ¤Ë¥ï¥¤¥Éʸ»ú½ÐÎÏ
75 ¤ò¹Ô¤Ê¤¦¡£ \fIstream\fP ¤¬¥Ð¥¤¥Èñ°ÌÆþ½ÐÎϤǤ¢¤Ã¤Æ¤Ï¤¤¤±¤Ê¤¤¡£
83 ´Ø¿ô¤Ï¥ï¥¤¥Éʸ»ú¤ÎÇÛÎó¤Ë
84 ¥ï¥¤¥Éʸ»ú½ÐÎϤò¹Ô¤Ê¤¦¡£¥×¥í¥°¥é¥Þ¡¼¤Ï \fIwcs\fP ¤ËºÇÄã¤Ç¤â
85 \fImaxlen\fP ʸ»ú¤Î¥ï¥¤¥Éʸ»ú¤ò½ÐÎϤǤ¤ë¶õ¤¤¬¤¢¤ë¤³¤È¤òÊݾڤ·¤Ê¤±¤ì¤Ð
95 ´Ø¿ô¤Ë»÷¤Æ¤¤¤ë¤¬°Ê²¼¤Î
99 \fIformat\fP ¤¬¥ï¥¤¥Éʸ»úÎó¤ÇÍ¿¤¨¤é¤ì¤ë¡£
102 ½ÐÎϤ¬¥Ð¥¤¥È¤Ç¤Ï¤Ê¤¯¥ï¥¤¥Éʸ»ú¤Ç¹½À®¤µ¤ì¤ë¡£
108 ¤Ï \fImaxlen\fP °ú¤¿ô¤ò¼è¤ë¤¬¡¢
116 ¤Ï \fImaxlen\fP °ú¤¿ô¤ò¼è¤ë¤¬
117 ¤³¤ì¤é¤Î´Ø¿ô¤¬ Linux ¤Ç¤Ï¡¢¥Ð¥Ã¥Õ¥¡¡¼¤¬°î¤ì¤¿¾ì¹ç¤Ç¤â \-1 ¤òÊÖ¤µ¤Ê¤¤)¡£
119 \fBc\fP ¤È \fBs\fP ÊÑ´¹Ê¸»ú¤Î°·¤¤¤¬°Û¤Ã¤Æ¤¤¤ë:
124 ½¤¾þ»Ò¤¬Â¸ºß¤·¤Ê¤¤¾ì¹ç¤Ï
128 ´Ø¿ô¤Ë¤è¤Ã¤Æ¥ï¥¤¥Éʸ»ú¤ËÊÑ´¹¤µ¤ì¤ë¡£¤½¤·¤Æ·ë²Ì¤Î¥ï¥¤¥Éʸ»ú¤¬½ÐÎϤµ¤ì¤ë¡£
130 ½¤¾þ»Ò¤¬Â¸ºß¤¹¤ë¾ì¹ç¤Ï
132 (¥ï¥¤¥Éʸ»ú)°ú¤¿ô¤¬½ÐÎϤµ¤ì¤ë¡£
137 ½¤¾þ»Ò¤¬Â¸ºß¤·¤Ê¤¤¾ì¹ç¡¢
139 °ú¤¿ô¤Ï½é´ü¾õÂÖ¤è¤ê»Ï¤Þ¤ë¥Þ¥ë¥Á¥Ð¥¤¥Èʸ»úÎó¤ò´Þ¤ó¤À
140 char ·¿¤ÎÇÛÎó¤Ø¤Î¥Ý¥¤¥ó¥¿¡¼(ʸ»úÎó¤Ø¤Î¥Ý¥¤¥ó¥¿¡¼)¤È¤ß¤Ê¤µ¤ì¤ë¡£
141 ÇÛÎó¤Îʸ»ú¤Ï(ºÇ½é¤Î¥Ð¥¤¥ÈÁ°¤Ë½é´ü¾õÂÖ¤ÇÊÑ´¹¤ò³«»Ï¤·¡¢¤½¤ì¤¾¤ì¤Îʸ»ú¤ò
143 ´Ø¿ô¤Ë¤è¤Ã¤Æ)¥ï¥¤¥Éʸ»ú¤Ø¤ÈÊÑ´¹¤µ¤ì¤ë¡£·ë²Ì¤Î¥ï¥¤¥Éʸ»ú¤Ï½ªÃ¼¤Î
144 ¥Ê¥ë¥ï¥¤¥Éʸ»ú¤Î¼êÁ°¤Þ¤Ç¤¬½ñ¤¹þ¤Þ¤ì¤ë¡£ÀºÅÙ(precision)¤¬»ØÄꤵ¤ì¤¿
145 ¾ì¹ç¡¢»ØÄꤵ¤ì¤¿¿ô»ú¤òĶ¤¨¤ë¥ï¥¤¥Éʸ»ú¤Ï½ñ¤¹þ¤Þ¤ì¤Ê¤¤¡£ÀºÅÙ¤Ï
152 ¤Î¿ô¤ò»ØÄꤹ¤ë¤³¤È¤ËÃí°Õ¤¹¤ë¤³¤È¡£
153 ÀºÅÙ¤¬¤Ê¤¤¾ì¹ç¤Ë¤ÏÇÛÎó¤Î½ªÃ¼¤Ë¥Ê¥ëʸ»ú¤ò´Þ¤àɬÍפ¬¤¢¤ë¡£
154 ÀºÅÙ¤ò»ØÄꤹ¤ë¾ì¹ç¤Ë¤Ï¡¢ÇÛÎó¤ÎºÇ¸å¤ËÅþÃ夹¤ëÁ°¤ËÊÑ´¹¤µ¤ì¤¿¥ï¥¤¥Éʸ»ú¤Î
155 ¿ô¤¬¤½¤ì¤ËÅþ㤹¤ë¤è¤¦¡¢ÀºÅ٤Ͻ½Ê¬¤Ë¾®¤µ¤Ê¿ô¤Ç¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
158 ½¤¾þ»Ò¤¬Â¸ºß¤¹¤ë¾ì¹ç¡¢
159 .I "const\ wchar_t\ *"
160 °ú¤¿ô¤Ï¥ï¥¤¥Éʸ»ú¤ÎÇÛÎó¤Ø¤Î¥Ý¥¤¥ó¥¿¡¼¤È¤ß¤Ê¤µ¤ì¤ë¡£
161 ÇÛÎó¤Î¥ï¥¤¥Éʸ»úÎó¤Ï½ªÃ¼¤Î¥Ê¥ë¥ï¥¤¥Éʸ»ú¤Î¼ê´Ö¤Þ¤Ç½ÐÎϤµ¤ì¤ë¡£
162 ¤â¤·ÀºÅÙ¤¬»ØÄꤵ¤ì¤¿¾ì¹ç¤Ë¤Ï»ØÄꤵ¤ì¤¿ÀºÅٰʾå¤Îʸ»ú¤Ï½ÐÎϤµ¤ì¤Ê¤¤¡£
163 ÀºÅÙ¤ò»ØÄꤷ¤Ê¤¤¾ì¹ç¤Ë¤Ï½ªÃ¼¤Î¥Ê¥ë¥ï¥¤¥Éʸ»ú¤ò´Þ¤àɬÍפ¬¤¢¤ë¡£
164 ÀºÅÙ¤ò»ØÄꤹ¤ë¾ì¹ç¤Ë¤Ï¤½¤ì¤Ï¥ï¥¤¥Éʸ»ú¤ÎÇÛÎó¤ÎÂ礤µ¤è¤ê¤â¾®¤µ¤¯¤Ê
167 ¤³¤ì¤é¤Î´Ø¿ô¤Ï½ñ¤¹þ¤Þ¤ì¤¿¥ï¥¤¥Éʸ»ú¤Îʸ»ú¿ô¤òÊÖ¤¹¡£
172 ½ªÃ¼¤Î¥Ê¥ë¥ï¥¤¥Éʸ»ú¤Ï´Þ¤Þ¤Ê¤¤¡£¥¨¥é¡¼¤¬µ¯¤³¤Ã¤¿¾ì¹ç¤Ï \-1 ¤òÊÖ¤¹¡£
177 Åù¤ÎÆ°ºî¤Ï¸½ºß¤Î¥í¥±¡¼¥ë¤Î
179 ¥«¥Æ¥´¥ê¤Ë°Í¸¤·¤Æ¤¤¤ë¡£
181 \fIformat\fP ʸ»úÎó¤¬ ASCII °Ê³°¤Î¥ï¥¤¥Éʸ»ú¤ò´Þ¤ó¤Ç¤¤¤ë¾ì¹ç¡¢
184 ¥«¥Æ¥´¥ê¤¬¥³¥ó¥Ñ¥¤¥ë»þ¤Î
187 °ìÃפ·¤Æ¤¤¤ë¾ì¹ç¤Ë¤Î¤ß¥×¥í¥°¥é¥à¤ÏÀµ¾ï¤ËÆ°ºî¤¹¤ë¡£¤³¤ì¤Ï
189 ¤Îɽ¸½¤¬¥í¥±¡¼¥ë¤ä¥×¥é¥Ã¥È¥Û¡¼¥à¤Ë°Í¸¤·¤Æ¤¤¤ë¤³¤È¤Ë¸¶°ø¤¬¤¢¤ë¡£
190 (glibc ¤Ç¤Ï¥ï¥¤¥Éʸ»ú¤È¤·¤Æ Unicode (ISO-10646) ¤Î¥³¡¼¥É¥Ý¥¤¥ó¥È¤ò
191 »ÈÍѤ·¤Æ¤¤¤ë¡£Â¾¤Î¥×¥é¥Ã¥È¥Û¡¼¥à¤Ç¤Ï¤½¤¦¤Ç¤Ï¤Ê¤¤¡£Æ±ÍͤË
192 ISO C99 ¤Î \\unnnn ·Á¼°¤ÎÈÆÍÑʸ»ú̾¾Î¤Ï¤³¤ÎÌäÂê¤ò²ò·è¤·¤Ê¤¤¡£)
193 ¤³¤Î¤¿¤á¹ñºÝ²½¤µ¤ì¤¿¥×¥í¥°¥é¥à¤Ç¤Ï \fIformat\fP ʸ»úÎó¤ò ASCII ¥ï¥¤¥É
194 ʸ»ú¤Î¤ß¤Ë¤¹¤ë¤«¡¢¼Â¹Ô»þ¤Ë¹ñºÝ²½¤µ¤ì¤¿ÊýË¡¤Ç¹½À®¤¹¤ëɬÍפ¬¤¢¤ë
201 ¤òÁȤ߹ç¤ï¤Æ»ÈÍѤ¹¤ë)¡£