[linuxjm/LDP_man-pages.git] / release / man3 / wprintf.3

.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\"
.\" References consulted:
.\"   GNU glibc-2 source code and manual
.\"   Dinkumware C library reference http://www.dinkumware.com/
.\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
.\"   ISO/IEC 9899:1999
.\"
.\" Japanese Version Copyright (c) 1999 HANATAKA Shinya
.\"         all rights reserved.
.\" Translated Tue Jan 11 00:55:36 JST 2000
.\"         by HANATAKA Shinya <hanataka@abyss.rim.or.jp>
.\"
.TH WPRINTF 3  2010-09-20 "GNU" "Linux Programmer's Manual"
.SH ̾Á°
wprintf, fwprintf, swprintf, vwprintf, vfwprintf, vswprintf \- ¥ï¥¤¥Éʸ»ú¤ò
¥Õ¥©¡¼¥Þ¥Ã¥È¤·¤Æ½ÐÎϤ¹¤ë
.SH ½ñ¼°
.nf
.B #include <stdio.h>
.B #include <wchar.h>
.sp
.BI "int wprintf(const wchar_t *" format ", ...);"
.BI "int fwprintf(FILE *" stream ", const wchar_t *" format ", ...);"
.BI "int swprintf(wchar_t *" wcs ", size_t " maxlen ,
.BI "             const wchar_t *" format ", ...);"
.sp
.BI "int vwprintf(const wchar_t *" format ", va_list " args );
.BI "int vfwprintf(FILE *" stream ", const wchar_t *" format ", va_list " args );
.BI "int vswprintf(wchar_t *" wcs ", size_t " maxlen ,
.BI "              const wchar_t *" format ", va_list " args );
.fi
.sp
.in -4n
glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
.RB ( feature_test_macros (7)
»²¾È):
.in
.sp
.ad l
¾åµ­¤ÎÁ´¤Æ¤Î´Ø¿ô:
.RS 4
.\" .BR wprintf (),
.\" .BR fwprintf (),
.\" .BR swprintf (),
.\" .BR vwprintf (),
.\" .BR vfwprintf (),
.\" .BR vswprintf ():
_XOPEN_SOURCE\ >=\ 500 || _ISOC99_SOURCE ||
_POSIX_C_SOURCE\ >=\ 200112L;
.br
or
.I cc\ -std=c99
.RE
.ad
.SH ÀâÌÀ
.BR wprintf ()
¥Õ¥¡¥ß¥ê¡¼¤Î´Ø¿ô¤Ï
.BR printf (3)
¥Õ¥¡¥ß¥ê¡¼¤Î´Ø¿ô¤Î
¥ï¥¤¥Éʸ»úÈǤǤ¢¤ë¡£¤³¤ì¤é¤Ï¥ï¥¤¥Éʸ»ú¤ò¥Õ¥©¡¼¥Þ¥Ã¥È¤·¤Æ½ÐÎϤ¹¤ë¡£
.PP
.BR wprintf ()
¤È
.BR vwprintf ()
´Ø¿ô¤Ï \fIstdout\fP ¤Ë½ÐÎϤò¹Ô¤Ê¤¦¡£
\fIstdout\fP ¤¬¥Ð¥¤¥Èñ°ÌÆþ½ÐÎϤǤ¢¤Ã¤Æ¤Ï¤¤¤±¤Ê¤¤¡£¤è¤ê¾Ü¤·¤¤ÀâÌÀ¤Ï
.BR fwide (3)
¤ò»²¾È¤¹¤ë¤³¤È¡£
.PP
.BR fwprintf ()
¤È
.BR vfwprintf ()
´Ø¿ô¤Ï \fIstream\fP ¤Ë¥ï¥¤¥Éʸ»ú½ÐÎÏ
¤ò¹Ô¤Ê¤¦¡£ \fIstream\fP ¤¬¥Ð¥¤¥Èñ°ÌÆþ½ÐÎϤǤ¢¤Ã¤Æ¤Ï¤¤¤±¤Ê¤¤¡£
¤è¤ê¾Ü¤·¤¤ÀâÌÀ¤Ï
.BR fwide (3)
¤ò»²¾È¤¹¤ë¤³¤È¡£
.PP
.BR swprintf ()
¤È
.BR vswprintf ()
´Ø¿ô¤Ï¥ï¥¤¥Éʸ»ú¤ÎÇÛÎó¤Ë
¥ï¥¤¥Éʸ»ú½ÐÎϤò¹Ô¤Ê¤¦¡£¥×¥í¥°¥é¥Þ¡¼¤Ï \fIwcs\fP ¤ËºÇÄã¤Ç¤â
\fImaxlen\fP ʸ»ú¤Î¥ï¥¤¥Éʸ»ú¤ò½ÐÎϤǤ­¤ë¶õ¤­¤¬¤¢¤ë¤³¤È¤òÊݾڤ·¤Ê¤±¤ì¤Ð
¤Ê¤é¤Ê¤¤¡£
.PP
¤³¤ì¤é¤Î´Ø¿ô¤Ï
.BR printf (3),
.BR vprintf (3),
.BR fprintf (3),
.BR vfprintf (3),
.BR sprintf (3),
.BR vsprintf (3)
´Ø¿ô¤Ë»÷¤Æ¤¤¤ë¤¬°Ê²¼¤Î
ÅÀ¤Ç°Û¤Ã¤Æ¤¤¤ë¡£
.TP
.B \(bu
\fIformat\fP ¤¬¥ï¥¤¥Éʸ»úÎó¤ÇÍ¿¤¨¤é¤ì¤ë¡£
.TP
.B \(bu
½ÐÎϤ¬¥Ð¥¤¥È¤Ç¤Ï¤Ê¤¯¥ï¥¤¥Éʸ»ú¤Ç¹½À®¤µ¤ì¤ë¡£
.TP
.B \(bu
.BR swprintf ()
¤È
.BR vswprintf ()
¤Ï \fImaxlen\fP °ú¤­¿ô¤ò¼è¤ë¤¬¡¢
.BR sprintf ()
¤È
.BR vsprintf ()
¤Ï¼è¤é¤Ê¤¤
.RB ( snprintf ()
¤È
.BR vsnprintf ()
¤Ï \fImaxlen\fP °ú¤­¿ô¤ò¼è¤ë¤¬
¤³¤ì¤é¤Î´Ø¿ô¤¬ Linux ¤Ç¤Ï¡¢¥Ð¥Ã¥Õ¥¡¡¼¤¬°î¤ì¤¿¾ì¹ç¤Ç¤â \-1 ¤òÊÖ¤µ¤Ê¤¤)¡£
.PP
\fBc\fP ¤È \fBs\fP ÊÑ´¹Ê¸»ú¤Î°·¤¤¤¬°Û¤Ã¤Æ¤¤¤ë:
.TP
.B c
¤â¤·
.B l
½¤¾þ»Ò¤¬Â¸ºß¤·¤Ê¤¤¾ì¹ç¤Ï
.I int
°ú¤­¿ô¤Ï
.BR btowc (3)
´Ø¿ô¤Ë¤è¤Ã¤Æ¥ï¥¤¥Éʸ»ú¤ËÊÑ´¹¤µ¤ì¤ë¡£¤½¤·¤Æ·ë²Ì¤Î¥ï¥¤¥Éʸ»ú¤¬½ÐÎϤµ¤ì¤ë¡£
.B l
½¤¾þ»Ò¤¬Â¸ºß¤¹¤ë¾ì¹ç¤Ï
.I wint_t
(¥ï¥¤¥Éʸ»ú)°ú¤­¿ô¤¬½ÐÎϤµ¤ì¤ë¡£
.TP
.B s
¤â¤·
.B l
½¤¾þ»Ò¤¬Â¸ºß¤·¤Ê¤¤¾ì¹ç¡¢
.I "const\ char\ *"
°ú¤­¿ô¤Ï½é´ü¾õÂÖ¤è¤ê»Ï¤Þ¤ë¥Þ¥ë¥Á¥Ð¥¤¥Èʸ»úÎó¤ò´Þ¤ó¤À
char ·¿¤ÎÇÛÎó¤Ø¤Î¥Ý¥¤¥ó¥¿¡¼(ʸ»úÎó¤Ø¤Î¥Ý¥¤¥ó¥¿¡¼)¤È¤ß¤Ê¤µ¤ì¤ë¡£
ÇÛÎó¤Îʸ»ú¤Ï(ºÇ½é¤Î¥Ð¥¤¥ÈÁ°¤Ë½é´ü¾õÂÖ¤ÇÊÑ´¹¤ò³«»Ï¤·¡¢¤½¤ì¤¾¤ì¤Îʸ»ú¤ò
.BR mbrtowc (3)
´Ø¿ô¤Ë¤è¤Ã¤Æ)¥ï¥¤¥Éʸ»ú¤Ø¤ÈÊÑ´¹¤µ¤ì¤ë¡£·ë²Ì¤Î¥ï¥¤¥Éʸ»ú¤Ï½ªÃ¼¤Î
¥Ê¥ë¥ï¥¤¥Éʸ»ú¤Î¼êÁ°¤Þ¤Ç¤¬½ñ¤­¹þ¤Þ¤ì¤ë¡£ÀºÅÙ(precision)¤¬»ØÄꤵ¤ì¤¿
¾ì¹ç¡¢»ØÄꤵ¤ì¤¿¿ô»ú¤òĶ¤¨¤ë¥ï¥¤¥Éʸ»ú¤Ï½ñ¤­¹þ¤Þ¤ì¤Ê¤¤¡£ÀºÅÙ¤Ï
½ñ¤­¹þ¤Þ¤ì¤ë
.I ¥Ð¥¤¥È
¿ô¤ä
.I ²èÌ̾å¤Î°ÌÃÖ
¤Ç¤Ï¤Ê¤¯
.I ¥ï¥¤¥Éʸ»ú
¤Î¿ô¤ò»ØÄꤹ¤ë¤³¤È¤ËÃí°Õ¤¹¤ë¤³¤È¡£
ÀºÅÙ¤¬¤Ê¤¤¾ì¹ç¤Ë¤ÏÇÛÎó¤Î½ªÃ¼¤Ë¥Ê¥ëʸ»ú¤ò´Þ¤àɬÍפ¬¤¢¤ë¡£
ÀºÅÙ¤ò»ØÄꤹ¤ë¾ì¹ç¤Ë¤Ï¡¢ÇÛÎó¤ÎºÇ¸å¤ËÅþÃ夹¤ëÁ°¤ËÊÑ´¹¤µ¤ì¤¿¥ï¥¤¥Éʸ»ú¤Î
¿ô¤¬¤½¤ì¤ËÅþ㤹¤ë¤è¤¦¡¢ÀºÅ٤Ͻ½Ê¬¤Ë¾®¤µ¤Ê¿ô¤Ç¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
¤â¤·
.B l
½¤¾þ»Ò¤¬Â¸ºß¤¹¤ë¾ì¹ç¡¢
.I "const\ wchar_t\ *"
°ú¤­¿ô¤Ï¥ï¥¤¥Éʸ»ú¤ÎÇÛÎó¤Ø¤Î¥Ý¥¤¥ó¥¿¡¼¤È¤ß¤Ê¤µ¤ì¤ë¡£
ÇÛÎó¤Î¥ï¥¤¥Éʸ»úÎó¤Ï½ªÃ¼¤Î¥Ê¥ë¥ï¥¤¥Éʸ»ú¤Î¼ê´Ö¤Þ¤Ç½ÐÎϤµ¤ì¤ë¡£
¤â¤·ÀºÅÙ¤¬»ØÄꤵ¤ì¤¿¾ì¹ç¤Ë¤Ï»ØÄꤵ¤ì¤¿ÀºÅٰʾå¤Îʸ»ú¤Ï½ÐÎϤµ¤ì¤Ê¤¤¡£
ÀºÅÙ¤ò»ØÄꤷ¤Ê¤¤¾ì¹ç¤Ë¤Ï½ªÃ¼¤Î¥Ê¥ë¥ï¥¤¥Éʸ»ú¤ò´Þ¤àɬÍפ¬¤¢¤ë¡£
ÀºÅÙ¤ò»ØÄꤹ¤ë¾ì¹ç¤Ë¤Ï¤½¤ì¤Ï¥ï¥¤¥Éʸ»ú¤ÎÇÛÎó¤ÎÂ礭¤µ¤è¤ê¤â¾®¤µ¤¯¤Ê
¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
.SH ÊÖ¤êÃÍ
¤³¤ì¤é¤Î´Ø¿ô¤Ï½ñ¤­¹þ¤Þ¤ì¤¿¥ï¥¤¥Éʸ»ú¤Îʸ»ú¿ô¤òÊÖ¤¹¡£
.BR swprintf ()
¤È
.BR vswprintf ()
´Ø¿ô¤Î¾ì¹ç¤Ï
½ªÃ¼¤Î¥Ê¥ë¥ï¥¤¥Éʸ»ú¤Ï´Þ¤Þ¤Ê¤¤¡£¥¨¥é¡¼¤¬µ¯¤³¤Ã¤¿¾ì¹ç¤Ï \-1 ¤òÊÖ¤¹¡£
.SH ½àµò
C99.
.SH Ãí°Õ
.BR wprintf ()
Åù¤ÎÆ°ºî¤Ï¸½ºß¤Î¥í¥±¡¼¥ë¤Î
.B LC_CTYPE
¥«¥Æ¥´¥ê¤Ë°Í¸¤·¤Æ¤¤¤ë¡£
.PP
\fIformat\fP ʸ»úÎó¤¬ ASCII °Ê³°¤Î¥ï¥¤¥Éʸ»ú¤ò´Þ¤ó¤Ç¤¤¤ë¾ì¹ç¡¢
¼Â¹Ô»þ¤Î¥í¥±¡¼¥ë¤Î
.B LC_CTYPE
¥«¥Æ¥´¥ê¤¬¥³¥ó¥Ñ¥¤¥ë»þ¤Î
.B LC_CTYPE
¥«¥Æ¥´¥ê¤È
°ìÃפ·¤Æ¤¤¤ë¾ì¹ç¤Ë¤Î¤ß¥×¥í¥°¥é¥à¤ÏÀµ¾ï¤ËÆ°ºî¤¹¤ë¡£¤³¤ì¤Ï
.I wchar_t
¤Îɽ¸½¤¬¥í¥±¡¼¥ë¤ä¥×¥é¥Ã¥È¥Û¡¼¥à¤Ë°Í¸¤·¤Æ¤¤¤ë¤³¤È¤Ë¸¶°ø¤¬¤¢¤ë¡£
(glibc ¤Ç¤Ï¥ï¥¤¥Éʸ»ú¤È¤·¤Æ Unicode (ISO-10646) ¤Î¥³¡¼¥É¥Ý¥¤¥ó¥È¤ò
»ÈÍѤ·¤Æ¤¤¤ë¡£Â¾¤Î¥×¥é¥Ã¥È¥Û¡¼¥à¤Ç¤Ï¤½¤¦¤Ç¤Ï¤Ê¤¤¡£Æ±ÍͤË
ISO C99 ¤Î \\unnnn ·Á¼°¤ÎÈÆÍÑʸ»ú̾¾Î¤Ï¤³¤ÎÌäÂê¤ò²ò·è¤·¤Ê¤¤¡£)
¤³¤Î¤¿¤á¹ñºÝ²½¤µ¤ì¤¿¥×¥í¥°¥é¥à¤Ç¤Ï \fIformat\fP ʸ»úÎó¤ò ASCII ¥ï¥¤¥É
ʸ»ú¤Î¤ß¤Ë¤¹¤ë¤«¡¢¼Â¹Ô»þ¤Ë¹ñºÝ²½¤µ¤ì¤¿ÊýË¡¤Ç¹½À®¤¹¤ëɬÍפ¬¤¢¤ë
(Î㤨¤Ð
.BR gettext ()
¤È
.BR iconv ()
¤ä
.BR mbstowcs ()
¤òÁȤ߹ç¤ï¤Æ»ÈÍѤ¹¤ë)¡£
.SH ´ØÏ¢¹àÌÜ
.BR fprintf (3),
.BR fputwc (3),
.BR fwide (3),
.BR printf (3),
.BR snprintf (3)
.\" .BR wscanf (3)