.\" 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 2011-09-17 "GNU" "Linux Programmer's Manual"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH WPRINTF 3 2011\-09\-17 GNU "Linux Programmer's Manual"
.SH 名前
wprintf, fwprintf, swprintf, vwprintf, vfwprintf, vswprintf \- ワイド文字を
フォーマットして出力する
.SH 書式
.nf
-.B #include <stdio.h>
-.B #include <wchar.h>
+\fB#include <stdio.h>\fP
+\fB#include <wchar.h>\fP
.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 ", ...);"
+\fBint wprintf(const wchar_t *\fP\fIformat\fP\fB, ...);\fP
+\fBint fwprintf(FILE *\fP\fIstream\fP\fB, const wchar_t *\fP\fIformat\fP\fB, ...);\fP
+\fBint swprintf(wchar_t *\fP\fIwcs\fP\fB, size_t \fP\fImaxlen\fP\fB,\fP
+\fB const wchar_t *\fP\fIformat\fP\fB, ...);\fP
.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 );
+\fBint vwprintf(const wchar_t *\fP\fIformat\fP\fB, va_list \fP\fIargs\fP\fB);\fP
+\fBint vfwprintf(FILE *\fP\fIstream\fP\fB, const wchar_t *\fP\fIformat\fP\fB, va_list \fP\fIargs\fP\fB);\fP
+\fBint vswprintf(wchar_t *\fP\fIwcs\fP\fB, size_t \fP\fImaxlen\fP\fB,\fP
+\fB const wchar_t *\fP\fIformat\fP\fB, va_list \fP\fIargs\fP\fB);\fP
.fi
.sp
.in -4n
-glibc 向けの機能検査マクロの要件
-.RB ( feature_test_macros (7)
-参照):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照):
.in
.sp
.ad l
.br
_POSIX_C_SOURCE\ >=\ 200112L;
.br
-or
-.I cc\ -std=c99
+or \fIcc\ \-std=c99\fP
.RE
.ad
.SH 説明
-.BR wprintf ()
-ファミリーの関数は
-.BR printf (3)
-ファミリーの関数の
+\fBwprintf\fP() ファミリーの関数は \fBprintf\fP(3) ファミリーの関数の
ワイド文字版である。これらはワイド文字をフォーマットして出力する。
.PP
-.BR wprintf ()
-と
-.BR vwprintf ()
-関数は \fIstdout\fP に出力を行なう。
-\fIstdout\fP がバイト単位入出力であってはいけない。より詳しい説明は
-.BR fwide (3)
-を参照すること。
+\fBwprintf\fP() と \fBvwprintf\fP() 関数は \fIstdout\fP に出力を行なう。 \fIstdout\fP
+がバイト単位入出力であってはいけない。より詳しい説明は \fBfwide\fP(3) を参照すること。
.PP
-.BR fwprintf ()
-と
-.BR vfwprintf ()
-関数は \fIstream\fP にワイド文字出力
-を行なう。 \fIstream\fP がバイト単位入出力であってはいけない。
-より詳しい説明は
-.BR fwide (3)
-を参照すること。
+\fBfwprintf\fP() と \fBvfwprintf\fP() 関数は \fIstream\fP にワイド文字出力 を行なう。 \fIstream\fP
+がバイト単位入出力であってはいけない。 より詳しい説明は \fBfwide\fP(3) を参照すること。
.PP
-.BR swprintf ()
-と
-.BR vswprintf ()
-関数はワイド文字の配列に
-ワイド文字出力を行なう。プログラマーは \fIwcs\fP に最低でも
-\fImaxlen\fP 文字のワイド文字を出力できる空きがあることを保証しなければ
-ならない。
+\fBswprintf\fP() と \fBvswprintf\fP() 関数はワイド文字の配列に ワイド文字出力を行なう。プログラマーは \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
+これらの関数は \fBprintf\fP(3), \fBvprintf\fP(3), \fBfprintf\fP(3), \fBvfprintf\fP(3),
+\fBsprintf\fP(3), \fBvsprintf\fP(3) 関数に似ているが以下の 点で異っている。
+.TP
+\fB\(bu\fP
\fIformat\fP がワイド文字列で与えられる。
-.TP
-.B \(bu
+.TP
+\fB\(bu\fP
出力がバイトではなくワイド文字で構成される。
-.TP
-.B \(bu
-.BR swprintf ()
-と
-.BR vswprintf ()
-は \fImaxlen\fP 引き数を取るが、
-.BR sprintf ()
-と
-.BR vsprintf ()
-は取らない
-.RB ( snprintf ()
-と
-.BR vsnprintf ()
-は \fImaxlen\fP 引き数を取るが
+.TP
+\fB\(bu\fP
+\fBswprintf\fP() と \fBvswprintf\fP() は \fImaxlen\fP 引き数を取るが、 \fBsprintf\fP() と
+\fBvsprintf\fP() は取らない (\fBsnprintf\fP() と \fBvsnprintf\fP() は \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
+\fBc\fP
+もし \fBl\fP 修飾子が存在しない場合は \fIint\fP 引き数は \fBbtowc\fP(3)
+関数によってワイド文字に変換される。そして結果のワイド文字が出力される。 \fBl\fP 修飾子が存在する場合は \fIwint_t\fP
(ワイド文字)引き数が出力される。
-.TP
-.B s
-もし
-.B l
-修飾子が存在しない場合、
-.I "const\ char\ *"
-引き数は初期状態より始まるマルチバイト文字列を含んだ
-char 型の配列へのポインター(文字列へのポインター)とみなされる。
-配列の文字は(最初のバイト前に初期状態で変換を開始し、それぞれの文字を
-.BR mbrtowc (3)
-関数によって)ワイド文字へと変換される。結果のワイド文字は終端の
-ナルワイド文字の手前までが書き込まれる。精度(precision)が指定された
-場合、指定された数字を超えるワイド文字は書き込まれない。精度は
-書き込まれる
-.I バイト
-数や
-.I 画面上の位置
-ではなく
-.I ワイド文字
-の数を指定することに注意すること。
-精度がない場合には配列の終端にナル文字を含む必要がある。
-精度を指定する場合には、配列の最後に到着する前に変換されたワイド文字の
-数がそれに到達するよう、精度は十分に小さな数でなければならない。
-もし
-.B l
-修飾子が存在する場合、
-.I "const\ wchar_t\ *"
-引き数はワイド文字の配列へのポインターとみなされる。
-配列のワイド文字列は終端のナルワイド文字の手間まで出力される。
-もし精度が指定された場合には指定された精度以上の文字は出力されない。
-精度を指定しない場合には終端のナルワイド文字を含む必要がある。
-精度を指定する場合にはそれはワイド文字の配列の大きさよりも小さくな
-ければならない。
+.TP
+\fBs\fP
+もし \fBl\fP 修飾子が存在しない場合、 \fIconst\ char\ *\fP 引き数は初期状態より始まるマルチバイト文字列を含んだ char
+型の配列へのポインタ(文字列へのポインタ)とみなされる。 配列の文字は(最初のバイト前に初期状態で変換を開始し、それぞれの文字を
+\fBmbrtowc\fP(3) 関数によって)ワイド文字へと変換される。結果のワイド文字は終端の
+ナルワイド文字の手前までが書き込まれる。精度(precision)が指定された 場合、指定された数字を超えるワイド文字は書き込まれない。精度は
+書き込まれる \fIバイト\fP 数や \fI画面上の位置\fP ではなく \fIワイド文字\fP の数を指定することに注意すること。
+精度がない場合には配列の終端にナル文字を含む必要がある。 精度を指定する場合には、配列の最後に到着する前に変換されたワイド文字の
+数がそれに到達するよう、精度は十分に小さな数でなければならない。 もし \fBl\fP 修飾子が存在する場合、 \fIconst\ wchar_t\ *\fP
+引き数はワイド文字の配列へのポインタとみなされる。 配列のワイド文字列は終端のナルワイド文字の手間まで出力される。
+もし精度が指定された場合には指定された精度以上の文字は出力されない。 精度を指定しない場合には終端のナルワイド文字を含む必要がある。
+精度を指定する場合にはそれはワイド文字の配列の大きさよりも小さくな ければならない。
.SH 返り値
-これらの関数は書き込まれたワイド文字の文字数を返す。
-.BR swprintf ()
-と
-.BR vswprintf ()
-関数の場合は
+これらの関数は書き込まれたワイド文字の文字数を返す。 \fBswprintf\fP() と \fBvswprintf\fP() 関数の場合は
終端のナルワイド文字は含まない。エラーが起こった場合は \-1 を返す。
.SH 準拠
C99.
.SH 注意
-.BR wprintf ()
-等の動作は現在のロケールの
-.B LC_CTYPE
-カテゴリに依存している。
+\fBwprintf\fP() 等の動作は現在のロケールの \fBLC_CTYPE\fP カテゴリに依存している。
.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 ()
-を組み合わて使用する)。
+\fIformat\fP 文字列が ASCII 以外のワイド文字を含んでいる場合、 実行時のロケールの \fBLC_CTYPE\fP カテゴリがコンパイル時の
+\fBLC_CTYPE\fP カテゴリと 一致している場合にのみプログラムは正常に動作する。これは \fIwchar_t\fP
+の表現がロケールやプラットホームに依存していることに原因がある。 (glibc ではワイド文字として Unicode (ISO\-10646)
+のコードポイントを 使用している。他のプラットホームではそうではない。同様に ISO C99 の \eunnnn
+形式の汎用文字名称はこの問題を解決しない。) このため国際化されたプログラムでは \fIformat\fP 文字列を ASCII ワイド
+文字のみにするか、実行時に国際化された方法で構成する必要がある (例えば \fBgettext\fP() と \fBiconv\fP() や
+\fBmbstowcs\fP() を組み合わて使用する)。
.SH 関連項目
-.BR fprintf (3),
-.BR fputwc (3),
-.BR fwide (3),
-.BR printf (3),
-.BR snprintf (3)
+\fBfprintf\fP(3), \fBfputwc\fP(3), \fBfwide\fP(3), \fBprintf\fP(3), \fBsnprintf\fP(3)
.\" .BR wscanf (3)