.\" 2000-07-26 jsm28@hermes.cam.ac.uk - three small fixes
.\" 2000-10-16 jsm28@hermes.cam.ac.uk - more fixes
.\"
-.\" Japanese Version Copyright (c) 1997 YOSHINO Takashi all rights reserved.
-.\" Translated 1998-02-17, YOSHINO Takashi <yoshino@civil.jcn.nihon-u.ac.jp>
-.\" Updated 2000-10-02, Kentaro Shirakata <argrath@ub32.org>
-.\" Updated 2001-01-29, Kentaro Shirakata <argrath@ub32.org>
-.\" Updated 2002-01-03, Kentaro Shirakata <argrath@ub32.org>
-.\" Updated 2002-10-17, Kentaro Shirakata <argrath@ub32.org>
-.\" Updated 2005-03-15, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
-.\" Updated 2006-07-20, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
-.\" Updated 2008-02-10, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v2.77
-.\" Updated 2009-03-03, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v3.19
+.\"*******************************************************************
.\"
-.\" WORD: conversion specifier 変換指定子
-.\" WORD: length modifier 長さ修飾子
+.\" This file was generated with po4a. Translate the source file.
.\"
-.TH PRINTF 3 2011-09-28 "GNU" "Linux Programmer's Manual"
+.\"*******************************************************************
+.TH PRINTF 3 2011\-09\-28 GNU "Linux Programmer's Manual"
.SH 名前
-printf, fprintf, sprintf, snprintf, vprintf, vfprintf, vsprintf,
-vsnprintf \- 指定された書式に変換して出力を行う
+printf, fprintf, sprintf, snprintf, vprintf, vfprintf, vsprintf, vsnprintf \-
+指定された書式に変換して出力を行う
.SH 書式
-.B #include <stdio.h>
+\fB#include <stdio.h>\fP
.sp
-.BI "int printf(const char *" format ", ...);"
+\fBint printf(const char *\fP\fIformat\fP\fB, ...);\fP
.br
-.BI "int fprintf(FILE *" stream ", const char *" format ", ...);"
+\fBint fprintf(FILE *\fP\fIstream\fP\fB, const char *\fP\fIformat\fP\fB, ...);\fP
.br
-.BI "int sprintf(char *" str ", const char *" format ", ...);"
+\fBint sprintf(char *\fP\fIstr\fP\fB, const char *\fP\fIformat\fP\fB, ...);\fP
.br
-.BI "int snprintf(char *" str ", size_t " size ", const char *" format ", ...);"
+\fBint snprintf(char *\fP\fIstr\fP\fB, size_t \fP\fIsize\fP\fB, const char *\fP\fIformat\fP\fB,
+\&...);\fP
.sp
-.B #include <stdarg.h>
+\fB#include <stdarg.h>\fP
.sp
-.BI "int vprintf(const char *" format ", va_list " ap );
+\fBint vprintf(const char *\fP\fIformat\fP\fB, va_list \fP\fIap\fP\fB);\fP
.br
-.BI "int vfprintf(FILE *" stream ", const char *" format ", va_list " ap );
+\fBint vfprintf(FILE *\fP\fIstream\fP\fB, const char *\fP\fIformat\fP\fB, va_list
+\fP\fIap\fP\fB);\fP
.br
-.BI "int vsprintf(char *" str ", const char *" format ", va_list " ap );
+\fBint vsprintf(char *\fP\fIstr\fP\fB, const char *\fP\fIformat\fP\fB, va_list
+\fP\fIap\fP\fB);\fP
.br
-.BI "int vsnprintf(char *" str ", size_t " size ", const char *" format \
-", va_list " ap );
+\fBint vsnprintf(char *\fP\fIstr\fP\fB, size_t \fP\fIsize\fP\fB, const char
+*\fP\fIformat\fP\fB, va_list \fP\fIap\fP\fB);\fP
.sp
.in -4n
-glibc 向けの機能検査マクロの要件
-.RB ( feature_test_macros (7)
-参照):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照):
.in
.sp
.ad l
-.BR snprintf (),
-.BR vsnprintf ():
+\fBsnprintf\fP(), \fBvsnprintf\fP():
.RS 4
_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _ISOC99_SOURCE ||
_POSIX_C_SOURCE\ >=\ 200112L;
.br
-or
-.I "cc -std=c99"
+or \fIcc \-std=c99\fP
.RE
.ad
.SH 説明
-.BR printf ()
-関数グループは、以下で述べるように、
-.I format
-に従って出力を生成するものである。
-.BR printf ()
-と
-.BR vprintf ()
-は出力を
-.I stdout
-(標準出力ストリーム) に書き出す。
-.BR fprintf ()
-と
-.BR vfprintf ()
-は出力を指定された出力
-.I stream
-に書き出す。
-.BR sprintf (),
-.BR snprintf (),
-.BR vsprintf (),
-.BR vsnprintf ()
-は出力を文字列
-.IR str
-に書き込む。
+\fBprintf\fP() 関数グループは、以下で述べるように、 \fIformat\fP に従って出力を生成するものである。 \fBprintf\fP() と
+\fBvprintf\fP() は出力を \fIstdout\fP (標準出力ストリーム) に書き出す。 \fBfprintf\fP() と
+\fBvfprintf\fP() は出力を指定された出力 \fIstream\fP に書き出す。 \fBsprintf\fP(), \fBsnprintf\fP(),
+\fBvsprintf\fP(), \fBvsnprintf\fP() は出力を文字列 \fIstr\fP に書き込む。
.PP
-.BR snprintf ()
-と
-.BR vsnprintf ()
-は最大で
-.I size
-バイトを
-.I str
-に書き込む
-.RI ( size
+\fBsnprintf\fP() と \fBvsnprintf\fP() は最大で \fIsize\fP バイトを \fIstr\fP に書き込む (\fIsize\fP
には文字列を終端する NULL バイト (\(aq\e0\(aq) もを含まれる)。
.PP
-.BR vprintf (),
-.BR vfprintf (),
-.BR vsprintf (),
-.BR vsnprintf ()
-の各関数はそれぞれ
-.BR printf (),
-.BR fprintf (),
-.BR sprintf (),
-.BR snprintf (),
-の各関数と等価であり、可変数引き数の代わりに
-.I va_list
-を引き数として呼び出される点だけが異なる。
-これらの関数では
-.I va_end
-マクロは呼び出されない。
-これらの関数は
-.I va_arg
-を呼び出すので、呼び出し後の
-.I ap
-の値は未定義である。
-.BR stdarg (3)
+\fBvprintf\fP(), \fBvfprintf\fP(), \fBvsprintf\fP(), \fBvsnprintf\fP() の各関数はそれぞれ
+\fBprintf\fP(), \fBfprintf\fP(), \fBsprintf\fP(), \fBsnprintf\fP(),
+の各関数と等価であり、可変数引き数の代わりに \fIva_list\fP を引き数として呼び出される点だけが異なる。 これらの関数では \fIva_end\fP
+マクロは呼び出されない。 これらの関数は \fIva_arg\fP を呼び出すので、呼び出し後の \fIap\fP の値は未定義である。 \fBstdarg\fP(3)
を参照のこと。
.PP
-これらの 8 つの関数は
-.I format
-文字列の制御に従って出力を書き出す。
-.I format
-文字列は、これに続く引き数 (または
-.BR stdarg (3)
-の可変長引き数機構を使ってアクセスできる引き数)
-をどのように変換して出力するかを指定する。
+これらの 8 つの関数は \fIformat\fP 文字列の制御に従って出力を書き出す。 \fIformat\fP 文字列は、これに続く引き数 (または
+\fBstdarg\fP(3) の可変長引き数機構を使ってアクセスできる引き数) をどのように変換して出力するかを指定する。
-C99 と POSIX.1-2001 では、
-.BR sprintf (),
-.BR snprintf (),
-.BR vsprintf (),
-.BR vsnprintf ()
-の呼び出しで、範囲が重複するオブジェクト間でコピーが発生する場合の
-結果は不定であると規定されている (例えば、出力先の文字列と入力された
-引き数の一つが同じバッファを参照している場合などである)。
-「注意」の節を参照。
-.SS 返り値
-成功時には、上記の関数は書き込まれた文字数を返す
-(文字列の最後を示すために使用する NULL バイトは数に含まれない)。
+C99 と POSIX.1\-2001 では、 \fBsprintf\fP(), \fBsnprintf\fP(), \fBvsprintf\fP(),
+\fBvsnprintf\fP() の呼び出しで、範囲が重複するオブジェクト間でコピーが発生する場合の 結果は不定であると規定されている
+(例えば、出力先の文字列と入力された 引き数の一つが同じバッファを参照している場合などである)。 「注意」の節を参照。
+.SS "Return Values"
+成功時には、上記の関数は書き込まれた文字数を返す (文字列の最後を示すために使用する NULL バイトは数に含まれない)。
-.BR snprintf ()
-と
-.BR vsnprintf ()
-は、
-.I size
-バイトを越える文字数を書き込まない
-.RI ( size
-には文字列を終端する NULL バイト (\(aq\e0\(aq) も含まれる)。
-この制限によって出力が切り詰められた場合には、
-もし十分なスペースがあれば書き込まれたであろう文字の個数
-(文字列を終端する NULL バイトを除く) を返す。
-従って、返り値が
-.I size
-以上だった場合、出力が切り詰められたことを意味する
-(後述の注意も参照のこと)。
+\fBsnprintf\fP() と \fBvsnprintf\fP() は、 \fIsize\fP バイトを越える文字数を書き込まない (\fIsize\fP
+には文字列を終端する NULL バイト (\(aq\e0\(aq) も含まれる)。 この制限によって出力が切り詰められた場合には、
+もし十分なスペースがあれば書き込まれたであろう文字の個数 (文字列を終端する NULL バイトを除く) を返す。 従って、返り値が \fIsize\fP
+以上だった場合、出力が切り詰められたことを意味する (後述の注意も参照のこと)。
エラーが発生した場合は、負の数を返す。
.SS フォーマット文字列のフォーマット
-フォーマット文字列は文字の列で、
-(もしあるなら) 初期シフト状態で始まり、初期シフト状態で終わる。
-フォーマット用の文字列は 0 個以上の命令 (directives) によって構成される。
-命令には、通常文字と変換指定 (conversion specifications) がある。
-通常文字は
-.B %
-以外の文字で、出力ストリームにそのままコピーされる。
-変換指定は、それぞれが 0 個以上の引き数を取る。
-各変換指定は文字
-.B %
-で始まり、
-.I "変換指定子 (conversion specifier)"
-で終わる。
-.B %
-と変換指定子の間には、0 個以上の
-.I フラグ 、
-最小
-.I フィールド幅 、
-.I 精度 、
-.I 長さ修飾子
-を (この順序で) 置くことができる。
-
-引き数は (型の格上げの後は) 変換指定子が表す型と正確に対応しなければならない。
-デフォルトでは、\(aq*\(aq や変換指定子が出てくる毎に次の引き数を要求され、
-引き数は指定された順序で使用されていく
-(指定された引き数の個数が不十分ならエラーとなる)。
-また、引き数が必要な箇所で \(aq%\(aq の代わりに "%m$"、
-\(aq*\(aqの代わりに "*m$" と書くことで、
-明示的にどの引き数を使用するかを指定することもできる。
-ここで 10進の整数 m は希望の引き数の引き数リストでの位置を示す
-(最初の引き数の番号が 1 である)。
-従って、以下の二つは等価である。
+フォーマット文字列は文字の列で、 (もしあるなら) 初期シフト状態で始まり、初期シフト状態で終わる。 フォーマット用の文字列は 0 個以上の命令
+(directives) によって構成される。 命令には、通常文字と変換指定 (conversion specifications) がある。
+通常文字は \fB%\fP 以外の文字で、出力ストリームにそのままコピーされる。 変換指定は、それぞれが 0 個以上の引き数を取る。 各変換指定は文字
+\fB%\fP で始まり、 \fI変換指定子 (conversion specifier)\fP で終わる。 \fB%\fP と変換指定子の間には、0 個以上の
+\fIフラグ 、\fP 最小 \fIフィールド幅 、\fP \fI精度 、\fP \fI長さ修飾子\fP を (この順序で) 置くことができる。
+
+引き数は (型の格上げの後は) 変換指定子が表す型と正確に対応しなければならない。 デフォルトでは、\(aq*\(aq
+や変換指定子が出てくる毎に次の引き数を要求され、 引き数は指定された順序で使用されていく (指定された引き数の個数が不十分ならエラーとなる)。
+また、引き数が必要な箇所で \(aq%\(aq の代わりに "%m$"、 \(aq*\(aqの代わりに "*m$" と書くことで、
+明示的にどの引き数を使用するかを指定することもできる。 ここで 10進の整数 m は希望の引き数の引き数リストでの位置を示す (最初の引き数の番号が 1
+である)。 従って、
.in +4n
.nf
printf("%*d", width, num);
+.fi
+.in
+と
+.in +4n
+.nf
+
printf("%2$*1$d", width, num);
.fi
.in
-は等価である。
-二番目の書き方では同じ引き数を繰り返し参照することができる。
-C99 標準には、 Single UNIX Specification 由来の \(aq$\(aq を使った書き方は含まれていない。
-\(aq$\(aq を使ったスタイルを使うと、引き数を取る変換及び幅と精度の引き数を
-全てこのスタイルで指定しなければならないが、
-引き数を消費しない "%%" フォーマットと混ざっているかもしれない。
-\(aq$\(aq で指定される引き数の番号に空きがあってはならない。
-例えば、もし引き数 1 と 3 が指定されると、引き数 2 もフォーマット文字列のどこかで
+は等価である。 二番目の書き方では同じ引き数を繰り返し参照することができる。 C99 標準には、 Single UNIX Specification
+由来の \(aq$\(aq を使った書き方は含まれていない。 \(aq$\(aq を使ったスタイルを使うと、引き数を取る変換及び幅と精度の引き数を
+全てこのスタイルで指定しなければならないが、 引き数を消費しない "%%" フォーマットと混ざっているかもしれない。 \(aq$\(aq
+で指定される引き数の番号に空きがあってはならない。 例えば、もし引き数 1 と 3 が指定されると、引き数 2 もフォーマット文字列のどこかで
指定されなければならない。
-数値変換には小数点や 1000 単位の区切り文字を使うものもある。
-実際にどの文字を使うかはロケールの
-.B LC_NUMERIC
-による。
-POSIX ロケールでは小数点に \(aq.\(aq を用い、
-区切り文字は使わない。
-従って、
+数値変換には小数点や 1000 単位の区切り文字を使うものもある。 実際にどの文字を使うかはロケールの \fBLC_NUMERIC\fP による。 POSIX
+ロケールでは小数点に \(aq.\(aq を用い、 区切り文字は使わない。 従って、
.in +4n
.nf
.fi
.in
-は、 POSIX ロケールでは "1234567.89" 、 nl_NL ロケールでは "1234567,89"、
-da_DK ロケールでは "1.234.567,89" となる。
+は、 POSIX ロケールでは "1234567.89" 、 nl_NL ロケールでは "1234567,89"、 da_DK ロケールでは
+"1.234.567,89" となる。
.SS フラグ文字
% 文字の後ろには 0 個以上のフラグ文字が続く。
-.TP
-.B #
-値は「別の形式」に変換される。
-.B o
-変換の場合、(先頭文字が 0 になっていない場合に先頭に 0 を追加することで)
-出力文字列の最初の文字を 0 にする。
-.B x
-と
-.B X
-変換の場合、数値が 0 でないときには文字列 "0x"
-.RB ( X
-変換の場合には "0X") が前に付与される。
-.BR a ,
-.BR A ,
-.BR e ,
-.BR E ,
-.BR f ,
-.BR F ,
-.BR g ,
-.B G
-変換では、 小数点に続く数字がなくても、
-出力には常に小数点が含まれる
-(通常は、小数点の後に数字が続く場合にのみ、
-小数点が表示される)。
-.B g
-と
-.B G
-変換の場合、他の変換とは異なり、末尾のゼロが変換結果から削除されない。
-その他の変換では、結果は未定義である。
-.TP
-.B \&0
-値をゼロで埋める。
-.BR d ,
-.BR i ,
-.BR o ,
-.BR u ,
-.BR x ,
-.BR X ,
-.BR a ,
-.BR A ,
-.BR e ,
-.BR E ,
-.BR f ,
-.BR F ,
-.BR g ,
-.B G
-変換では、変換した値の左側を空白文字の代わりにゼロで埋める。
-.B \&0
-と
-.B \-
-が両方とも指定された場合は、
-.B \&0
-フラグは無視される。
-精度が数値変換
-.RB ( d ,
-.BR i ,
-.BR o ,
-.BR u ,
-.BR x ,
-.BR X )
-と同時に指定された場合には、
-.B \&0
-フラグは無視される。
-その他の変換では、動作は未定義である。
-.TP
-.B \-
-変換値をフィールド境界で左揃えにする
-(デフォルトは右揃えである)。
-.B n
-変換以外では、変換された値は
-左側ではなく右側を空白文字やゼロで埋められる。
-.B \-
-と
-.B \&0
-の両方が指定された場合には、
-.B \-
-が優先される。
-.TP
-.B ' '
-(1個の半角スペース)
-符号付き変換で生成された正の数字の前に空白 (または空文字列) が置かれる。
-.TP
-.B +
-符号付き変換によって出力される数字の前に、常に符号 (+ か \-) が置かれる。
-デフォルトでは、符号は負の数字の場合のみ付与される。
-.B +
-と半角スペースの
-両方が使われている場合には、
-.B +
-が優先される。
+.TP
+\fB#\fP
+値は「別の形式」に変換される。 \fBo\fP 変換の場合、(先頭文字が 0 になっていない場合に先頭に 0 を追加することで) 出力文字列の最初の文字を
+0 にする。 \fBx\fP と \fBX\fP 変換の場合、数値が 0 でないときには文字列 "0x" (\fBX\fP 変換の場合には "0X") が前に付与される。
+\fBa\fP, \fBA\fP, \fBe\fP, \fBE\fP, \fBf\fP, \fBF\fP, \fBg\fP, \fBG\fP 変換では、 小数点に続く数字がなくても、
+出力には常に小数点が含まれる (通常は、小数点の後に数字が続く場合にのみ、 小数点が表示される)。 \fBg\fP と \fBG\fP
+変換の場合、他の変換とは異なり、末尾のゼロが変換結果から削除されない。 その他の変換では、結果は未定義である。
+.TP
+\fB\&0\fP
+値をゼロで埋める。 \fBd\fP, \fBi\fP, \fBo\fP, \fBu\fP, \fBx\fP, \fBX\fP, \fBa\fP, \fBA\fP, \fBe\fP, \fBE\fP, \fBf\fP,
+\fBF\fP, \fBg\fP, \fBG\fP 変換では、変換した値の左側を空白文字の代わりにゼロで埋める。 \fB\&0\fP と \fB\-\fP が両方とも指定された場合は、
+\fB\&0\fP フラグは無視される。 精度が数値変換 (\fBd\fP, \fBi\fP, \fBo\fP, \fBu\fP, \fBx\fP, \fBX\fP)
+と同時に指定された場合には、 \fB\&0\fP フラグは無視される。 その他の変換では、動作は未定義である。
+.TP
+\fB\-\fP
+変換値をフィールド境界で左揃えにする (デフォルトは右揃えである)。 \fBn\fP 変換以外では、変換された値は
+左側ではなく右側を空白文字やゼロで埋められる。 \fB\-\fP と \fB\&0\fP の両方が指定された場合には、 \fB\-\fP が優先される。
+.TP
+\&\fB' '\fP
+(1個の半角スペース) 符号付き変換で生成された正の数字の前に空白 (または空文字列) が置かれる。
+.TP
+\fB+\fP
+符号付き変換によって出力される数字の前に、常に符号 (+ か \-) が置かれる。 デフォルトでは、符号は負の数字の場合のみ付与される。 \fB+\fP
+と半角スペースの 両方が使われている場合には、 \fB+\fP が優先される。
.PP
-上記の 5 つのフラグは C 標準で定義されている。
-SUSv2 では、さらにもう一つフラグ文字が規定されている。
-.TP
-.B \(aq
-10進数変換
-.RB ( i ,
-.BR d ,
-.BR u ,
-.BR f ,
-.BR F ,
-.BR g ,
-.BR G )
-において、ロケール情報に指定があれば 1000 単位の区切り文字を出力する。
-.BR gcc (1)
-の多くのバージョンは、このオプションを解釈することができず、
-警告を出力することに注意せよ。
+上記の 5 つのフラグは C 標準で定義されている。 SUSv2 では、さらにもう一つフラグ文字が規定されている。
+.TP
+\fB\(aq\fP
+10進数変換 (\fBi\fP, \fBd\fP, \fBu\fP, \fBf\fP, \fBF\fP, \fBg\fP, \fBG\fP) において、ロケール情報に指定があれば 1000
+単位の区切り文字を出力する。 \fBgcc\fP(1) の多くのバージョンは、このオプションを解釈することができず、 警告を出力することに注意せよ。
%\(aqF は SUSv2 には含まれていない。
.PP
glibc 2.2 では、さらに一つフラグ文字が追加されている。
-.TP
-.B I
-10進整数変換
-.RB ( i ,
-.BR d ,
-.BR u )
-において、ロケールの代替出力数字があれば、それを用いて出力する。
-例えば、 glibc 2.2.3 以降では、ペルシア ("fa_IR") ロケールで
-アラビア数字 (Arabic-Indic digits) を出力できる。
-.\" ロケールファイルには outdigits というキーワードがある。
+.TP
+\fBI\fP
+.\" outdigits keyword in locale file
+10進整数変換 (\fBi\fP, \fBd\fP, \fBu\fP) において、ロケールの代替出力数字があれば、それを用いて出力する。 例えば、 glibc
+2.2.3 以降では、ペルシア ("fa_IR") ロケールで アラビア数字 (Arabic\-Indic digits) を出力できる。
.SS フィールド幅
-最小のフィールド幅を指定する 10進数の数値文字列 (文字列の最初の文字は
-ゼロ以外)。本項目はオプションである。
-変換された値の文字数がフィールド長よりも少ない場合、
-フィールドの左側をスペースで埋める
-(左揃えのフラグがある場合は右側を埋める)。
-10進数の文字列の代わりに "*" や "*m$" (\fIm\fP は 10進整数) を書くこともできる。
-"*" と "*m$" はそれぞれ、次の引き数と \fIm\fP 番目の引き数をフィールド幅として
-使うことを指定する (これらの引き数は
-.I int
-型でなければならない)。
-フィールド幅に負の数が指定された場合は、
-\(aq\-\(aq フラグと正の数のフィールド幅として扱われる。
-フィールド幅が小さかったり指定がなかったりしても、フィールドが切り詰められる
-ことはない。もし変換結果がフィールド幅よりも広かった場合、
+最小のフィールド幅を指定する 10進数の数値文字列 (文字列の最初の文字は ゼロ以外)。本項目はオプションである。
+変換された値の文字数がフィールド長よりも少ない場合、 フィールドの左側をスペースで埋める (左揃えのフラグがある場合は右側を埋める)。
+10進数の文字列の代わりに "*" や "*m$" (\fIm\fP は 10進整数) を書くこともできる。 "*" と "*m$" はそれぞれ、次の引き数と
+\fIm\fP 番目の引き数をフィールド幅として 使うことを指定する (これらの引き数は \fIint\fP 型でなければならない)。
+フィールド幅に負の数が指定された場合は、 \(aq\-\(aq フラグと正の数のフィールド幅として扱われる。
+フィールド幅が小さかったり指定がなかったりしても、フィールドが切り詰められる ことはない。もし変換結果がフィールド幅よりも広かった場合、
フィールドは変換結果が入る幅に広げられる。
.SS 精度
-オプションである精度は、ピリオド (\(aq.\(aq) とそれに続く10進数という
-形式で指定する (10進数はオプション) 。
-10進数の文字列の代わりに "*" や "*m$" (m は 10 進整数)を書くこともできる。
-"*" と "*m$" はそれぞれ、次の引き数と m 番目の引き数を精度として
-使うことを指定する (これらの引き数は
-.I int
-型でなければならない)。
-精度として \(aq.\(aq だけが指定されたり、精度が負の数だった場合、
-精度はゼロとみなされる。
-.BR d ,
-.BR i ,
-.BR o ,
-.BR u ,
-.BR x ,
-.B X
-変換では、表示される最小の桁数を指定する。
-.BR a ,
-.BR A ,
-.BR e ,
-.BR E ,
-.BR f ,
-.B F
-変換では、小数点以下に表示される数字の桁数を指定する。
-.B g
-と
-.B G
-変換では、有効数字の最大桁数を指定する。
-.B s
-と
-.B S
+オプションである精度は、ピリオド (\(aq.\(aq) とそれに続く10進数という 形式で指定する (10進数はオプション) 。
+10進数の文字列の代わりに "*" や "*m$" (m は 10 進整数)を書くこともできる。 "*" と "*m$" はそれぞれ、次の引き数と m
+番目の引き数を精度として 使うことを指定する (これらの引き数は \fIint\fP 型でなければならない)。 精度として \(aq.\(aq
+だけが指定されたり、精度が負の数だった場合、 精度はゼロとみなされる。 \fBd\fP, \fBi\fP, \fBo\fP, \fBu\fP, \fBx\fP, \fBX\fP
+変換では、表示される最小の桁数を指定する。 \fBa\fP, \fBA\fP, \fBe\fP, \fBE\fP, \fBf\fP, \fBF\fP
+変換では、小数点以下に表示される数字の桁数を指定する。 \fBg\fP と \fBG\fP 変換では、有効数字の最大桁数を指定する。 \fBs\fP と \fBS\fP
変換では、文字列から出力される最大文字数を指定する。
.SS 長さ修飾子
-「整数変換」とは、
-.BR d ,
-.BR i ,
-.BR o ,
-.BR u ,
-.BR x ,
-.B X
-変換のことである。
-.TP
-.B hh
-整数変換に対応する引き数が
-.I signed char
-か
-.I unsigned char
-で、
-.B n
-変換に対応する引き数が
-.I signed char
-へのポインタであることを示す。
-.TP
-.B h
-整数変換に対応する引き数が
-.I short int
-か
-.I unsigned short int
-で、
-.B n
-変換に対応する引き数が
-.I short int
-へのポインタであることを示す。
-.TP
-.BR l " (エル)"
-各変換に対応する引き数が、
-整数変換では
-.IR "long int" か
-.IR "unsigned long int" 、
-.B n
-変換では
-.I long long int
-へのポインタ、
-.B c
-変換では
-.IR wint_t 、
-.B s
-変換では
-.I wchar_t
-へのポインタであることを示す。
-
-.TP
-.BR ll " (エルエル)"
-整数変換に対応する引き数が
-.I long long int
-か
-.I unsigned long long int
-で、
-.B n
-変換に対応する引き数が
-.I long int
-へのポインタであることを示す。
-.TP
-.B L
-.BR a ,
-.BR A ,
-.BR e ,
-.BR E ,
-.BR f ,
-.BR F ,
-.BR g ,
-.B G
-変換に対応する引き数が
-.I long double
-であることを示す。
-(C99 では %LF を使うことを認めているが、SUSv2 では認められていない。)
-.TP
-.B q
-("quad"。 4.4BSD と Linux libc5 のみ有効。使ってはならない。)
-.B ll
-と同じ意味である。
-.TP
-.B j
-整数変換に対応する引き数が
-.I intmax_t
-か
-.I uintmax_t
-であることを示す。
-.TP
-.B z
-整数変換に対応する引き数が
-.I size_t
-か
-.I ssize_t
-であることを示す。
-(Linux libc5 では、これを指定するのに
-.B Z
-を用いる。使ってはならない。)
-.TP
-.B t
-整数変換に対応する引き数が
-.I ptrdiff_t
-であることを示す。
+「整数変換」とは、 \fBd\fP, \fBi\fP, \fBo\fP, \fBu\fP, \fBx\fP, \fBX\fP 変換のことである。
+.TP
+\fBhh\fP
+整数変換に対応する引き数が \fIsigned char\fP か \fIunsigned char\fP で、 \fBn\fP 変換に対応する引き数が \fIsigned
+char\fP へのポインタであることを示す。
+.TP
+\fBh\fP
+整数変換に対応する引き数が \fIshort int\fP か \fIunsigned short int\fP で、 \fBn\fP 変換に対応する引き数が
+\fIshort int\fP へのポインタであることを示す。
+.TP
+\fBl\fP
+各変換に対応する引き数が、 整数変換では \fIlong int\fPか \fIunsigned long int\fP、 \fBn\fP 変換では \fIlong
+long int\fP へのポインタ、 \fBc\fP 変換では \fIwint_t\fP、 \fBs\fP 変換では \fIwchar_t\fP へのポインタであることを示す。
+.TP
+\fBll\fP (エルエル)
+整数変換に対応する引き数が \fIlong long int\fP か \fIunsigned long long int\fP で、 \fBn\fP
+変換に対応する引き数が \fIlong int\fP へのポインタであることを示す。
+.TP
+\fBL\fP
+\fBa\fP, \fBA\fP, \fBe\fP, \fBE\fP, \fBf\fP, \fBF\fP, \fBg\fP, \fBG\fP 変換に対応する引き数が \fIlong double\fP
+であることを示す。 (C99 では %LF を使うことを認めているが、SUSv2 では認められていない。)
+.TP
+\fBq\fP
+("quad"。 4.4BSD と Linux libc5 のみ有効。使ってはならない。) \fBll\fP と同じ意味である。
+.TP
+\fBj\fP
+整数変換に対応する引き数が \fIintmax_t\fP か \fIuintmax_t\fP であることを示す。
+.TP
+\fBz\fP
+整数変換に対応する引き数が \fIsize_t\fP か \fIssize_t\fP であることを示す。 (Linux libc5 では、これを指定するのに
+\fBZ\fP を用いる。使ってはならない。)
+.TP
+\fBt\fP
+整数変換に対応する引き数が \fIptrdiff_t\fP であることを示す。
.PP
-SUSv2 で長さ修飾子として使用できるのは、
-.B h
-.RB ( hd ,
-.BR hi ,
-.BR ho ,
-.BR hx ,
-.BR hX ,
-.BR hn ),
-.B l
-.RB ( ld ,
-.BR li ,
-.BR lo ,
-.BR lx ,
-.BR lX ,
-.BR ln ,
-.BR lc ,
-.BR ls ),
-.B L
-.RB ( Le ,
-.BR LE ,
-.BR Lf ,
-.BR Lg ,
-.BR LG )
-だけである。
+SUSv2 で長さ修飾子として使用できるのは、 \fBh\fP (\fBhd\fP, \fBhi\fP, \fBho\fP, \fBhx\fP, \fBhX\fP, \fBhn\fP),
+\fBl\fP (\fBld\fP, \fBli\fP, \fBlo\fP, \fBlx\fP, \fBlX\fP, \fBln\fP, \fBlc\fP, \fBls\fP), \fBL\fP (\fBLe\fP,
+\fBLE\fP, \fBLf\fP, \fBLg\fP, \fBLG\fP) だけである。
.SS 変換指定子
-適用される変換の型を指定する文字。
-.PP
-変換指定子とその意味は以下の通りである。
-.TP
-.BR d ", " i
-.I int
-引き数を符号付き 10 進表記に変換する。
-精度指定があれば、精度で指定した桁数は必ず出力される。変換後の値が
-指定された桁数に足りない場合は、左側が 0 で埋められる。
-デフォルトの精度は 1 である。
-0 を表示しようとした時に、明示的に精度として 0 が指定されていると、
-出力は空文字列となる。
-.TP
-.BR o ", " u ", " x ", " X
-.I "unsigned int"
-引き数を、
-符号なし8進数
-.RB ( o ),
-符号なし10進数
-.RB ( u ),
-符号なし16進数
-.RB ( x
-と
-.BR X )
-に変換する。
-.B x
-変換では
-.B abcdef
-が使用され、
-.B X
-変換では
-.B ABCDEF
-が使用される。
-精度指定があれば、精度で指定した桁数は必ず出力される。変換後の値が
-指定された桁数に足りない場合は、左側が 0 で埋められる。
-.TP
-.BR e ", " E
-.I double
-引き数を丸めて
-.if \w'\*(Pm'=0 .ds Pm \(+-
-.RB [\-]d \&. ddd e \\*(Pmdd
-の形に変換する。
-小数点の前には一桁の数字があり、小数点以下の桁数は精度で指定された
-桁数になる。精度は指定されなかった場合 6 とみなされる。
-精度が 0 の場合には、小数点以下は表示されない。
-.B E
-変換では、指数を表現するときに
-.RB ( e
-ではなく)
-.B E
-が使われる。
-指数部分は少なくとも 2桁表示される。
-つまり、指数の値が 0 の場合には、00 と表示される。
-.TP
-.BR f ", " F
-.I double
-引き数を丸めて
-.RB [\-]ddd \&. ddd
-の形の10進表現に変換する。
-小数点の後の桁数は、精度で指定された値となる。
-精度が指定されていない場合には 6 として扱われる。
-精度として明示的に 0 が指定されたときには、小数点以下は表示されない。
+適用される変換の型を指定する文字。 変換指定子とその意味は以下の通りである。
+.TP
+\fBd\fP, \fBi\fP
+\fIint\fP 引き数を符号付き 10 進表記に変換する。 精度指定があれば、精度で指定した桁数は必ず出力される。変換後の値が
+指定された桁数に足りない場合は、左側が 0 で埋められる。 デフォルトの精度は 1 である。 0 を表示しようとした時に、明示的に精度として 0
+が指定されていると、 出力は空文字列となる。
+.TP
+\fBo\fP, \fBu\fP, \fBx\fP, \fBX\fP
+\fIunsigned int\fP 引き数を、 符号なし8進数 (\fBo\fP), 符号なし10進数 (\fBu\fP), 符号なし16進数 (\fBx\fP と
+\fBX\fP) に変換する。 \fBx\fP 変換では \fBabcdef\fP が使用され、 \fBX\fP 変換では \fBABCDEF\fP が使用される。
+精度指定があれば、精度で指定した桁数は必ず出力される。変換後の値が 指定された桁数に足りない場合は、左側が 0 で埋められる。
+.TP
+\fBe\fP, \fBE\fP
+\fIdouble\fP 引き数を丸めて
+.if \w'\*(Pm'=0 .ds Pm \(+-
+[\-]d\fB\&.\fPddd\fBe\fP\*(Pmdd の形に変換する。 小数点の前には一桁の数字があり、小数点以下の桁数は精度で指定された
+桁数になる。精度は指定されなかった場合 6 とみなされる。 精度が 0 の場合には、小数点以下は表示されない。 \fBE\fP 変換では、指数を表現するときに
+(\fBe\fP ではなく) \fBE\fP が使われる。 指数部分は少なくとも 2桁表示される。 つまり、指数の値が 0 の場合には、00 と表示される。
+.TP
+\fBf\fP, \fBF\fP
+\fIdouble\fP 引き数を丸めて [\-]ddd\fB\&.\fPddd の形の10進表現に変換する。 小数点の後の桁数は、精度で指定された値となる。
+精度が指定されていない場合には 6 として扱われる。 精度として明示的に 0 が指定されたときには、小数点以下は表示されない。
小数点を表示する際には、小数点の前に少なくとも一桁は数字が表示される。
-(SUSv2 では、
-.B F
-は規定されておらず、無限や NaN に関する文字列表現を
+(SUSv2 では、\fBF\fP は規定されておらず、無限や NaN に関する文字列表現を
行ってもよいことになっている。
- C99 標準では、
-.B f
-変換では、無限は "[\-]inf" か "[\-]infinity" と表示し、
+ C99 標準では、\fBf\fP 変換では、無限は "[\-]inf" か "[\-]infinity" と表示し、
NaN は文字列の先頭に `nan' をつけて表示するように規定されている。
-.B F
-変換の場合は "[\-]INF", "[\-]INFINITY", "NAN*" と表示される。)
-.TP
-.BR g ", " G
-.I double
-引き数を
-.B f
-か
-.B e
-.RB ( G
-変換の場合は
-.B F
-か
-.BR E )
-の形式に変換する。
-精度は表示する桁数を指定する。
-精度が指定されない場合は、6桁とみなされる。
-精度が 0 の場合は、1桁とみなされる。
-変換される値の指数が、 \-4 より小さいか、精度以上の場合に、
-.B e
-形式が使用される。
-変換された結果の小数部分の末尾の 0 は削除される。小数点が表示されるのは、
+\fBF\fP 変換の場合は "[\-]INF", "[\-]INFINITY", "NAN*" と表示される。)
+.TP
+\fBg\fP, \fBG\fP
+\fIdouble\fP 引き数を \fBf\fP か \fBe\fP (\fBG\fP 変換の場合は \fBF\fP か \fBE\fP) の形式に変換する。
+精度は表示する桁数を指定する。 精度が指定されない場合は、6桁とみなされる。 精度が 0 の場合は、1桁とみなされる。 変換される値の指数が、 \-4
+より小さいか、精度以上の場合に、 \fBe\fP 形式が使用される。 変換された結果の小数部分の末尾の 0 は削除される。小数点が表示されるのは、
小数点以下に数字が少なくとも一つある場合にだけである。
-.TP
-.BR a ", " A
-(C99 にはあるが SUSv2 にはない)
-.B a
-変換では、
-.I double
-引き数を (abcdef の文字を使って)
-.RB [\-] 0x h \&. hhhh p \\*(Pmd;
-形式の 16 進表記に変換する。
-.B A
-変換では、前置文字列
-.BR 0X ,
-文字 ABCDEF, 指数文字
-.B P
-を用いる。
-小数点の前には 1桁の16進数が置かれ、小数点の後ろの桁数は
-精度で指定された値となる。
-デフォルトの精度は、その値が 2進数で正確に表現できる場合には、
-その値を正確に表現できる桁数となる。それ以外の場合は、
-.I double
-型の値を区別するのに十分な大きさとなる。
-.\" motoki 2005/03/19: 合っているかな？
-小数点の前の数字は、正規化されていない数の場合はいくつになるか分からない。
-正規化された数の場合は、 0 以外の値になるが、いくつになるかは分からない。
-.TP
-.B c
-.B l
-修飾子がなければ、
-.I int
-引き数を
-.IR "unsigned char"
-に変換して、その結果に対応する文字を出力する。
-.B l
-修飾子があれば、
-.I wint_t
-(ワイド文字) 引き数を、
-.BR wcrtomb (3)
-関数を初期シフト状態で呼び出してマルチバイト文字列に変換し、
-変換されたマルチバイト文字列を出力する。
-.TP
-.B s
-.B l
-修飾子がない場合、
-引き数は
-.I "const char *"
-型で文字型の配列へのポインタ (文字列へのポインタ) であることが
-期待されている。配列中の文字は、終端の NULL バイト (\(aq\\0\(aq)
-が出てくるまで出力される (終端文字は出力されない)。
-精度が指定されていると、指定された字数以上は出力されない。
-精度が指定された場合には、終端バイトが存在する必要はない。
-精度が指定されていなかったり、精度の値が配列の大きさより大きい場合には、
-配列は終端の NULL バイトを含んでいなければならない。
-
-.B l
-修飾子が指定されている場合、
-引き数は
-.I "const wchar_t *"
-型でワイド文字の配列へのポインタであることが期待されている。
-配列中のワイド文字は (1文字毎に
-.BR wcrtomb (3)
-を呼び出して) マルチバイト文字に変換される
-(最初のワイド文字の変換の前に
-.BR wcrtomb ()
-のシフト状態を初期状態に戻してから変換は行われる)。
-マルチバイト文字への変換は、文字列を終端する NULL ワイド文字が
-出てくるまで行われ、終端 NULL ワイド文字も含めて変換される。
-結果のマルチバイト文字列は、終端の NULL バイトが出てくるまで
-出力される (終端の NULL バイトは出力されない)。
-精度が指定された場合、指定されたバイト数以上には出力されない。
-但し、マルチバイト文字の一部分だけが出力されることはない。
-精度は「バイト」数を指定するものであり、「ワイド文字」数や
-「画面での位置」を指定するものではないことに注意。
-精度が指定されていて、さらに出力が配列の末尾に達する前に出力バイト数が
-精度の値を超える場合だけは、配列は NULL ワイド文字で終端されていなくてもよい。
-それ以外の場合は、必ず配列は NULL ワイド文字で終端されていなければならない。
-.TP
-.B C
-(C99 にはないが SUSv2 にはある)
-.B lc
-と同じ。使ってはならない。
-.TP
-.B S
-(C99 にはないが SUSv2 にはある)
-.B ls
-と同じ。使ってはならない。
-.TP
-.B p
-.I "void *"
-ポインタ引き数を
-.RB ( %#x
-や
-.BR %#lx
-のような) 16 進数で出力する。
-.TP
-.B n
-これまでに出力された文字数を
-.I "int *"
-(または類似の型) のポインタ引き数が指す整数に保存する。
-引き数の変換は行われない。
-.TP
-.B m
-(glibc での拡張)
-.I strerror(errno)
-の出力を表示する。引き数は必要ない。
-.TP
-.B %
-\(aq%\(aq 文字を出力する。変換される引き数は無い。
-変換指定全体を書くと "%%" となる。
+.TP
+\fBa\fP, \fBA\fP
+(C99 にはあるが SUSv2 にはない) \fBa\fP 変換では、 \fIdouble\fP 引き数を (abcdef の文字を使って)
+[\-]\fB0x\fPh\fB\&.\fPhhhh\fBp\fP\*(Pmd; 形式の 16 進表記に変換する。 \fBA\fP 変換では、前置文字列 \fB0X\fP, 文字
+ABCDEF, 指数文字 \fBP\fP を用いる。 小数点の前には 1桁の16進数が置かれ、小数点の後ろの桁数は 精度で指定された値となる。
+デフォルトの精度は、その値が 2進数で正確に表現できる場合には、 その値を正確に表現できる桁数となる。それ以外の場合は、 \fIdouble\fP
+型の値を区別するのに十分な大きさとなる。 小数点の前の数字は、正規化されていない数の場合はいくつになるか分からない。 正規化された数の場合は、 0
+以外の値になるが、いくつになるかは分からない。
+.TP
+\fBc\fP
+\fBl\fP 修飾子がなければ、 \fIint\fP 引き数を \fIunsigned char\fP に変換して、その結果に対応する文字を出力する。 \fBl\fP
+修飾子があれば、 \fIwint_t\fP (ワイド文字) 引き数を、 \fBwcrtomb\fP(3)
+関数を初期シフト状態で呼び出してマルチバイト文字列に変換し、 変換されたマルチバイト文字列を出力する。
+.TP
+\fBs\fP
+\fBl\fP 修飾子がない場合、 引き数は \fIconst char *\fP 型で文字型の配列へのポインタ (文字列へのポインタ) であることが
+期待されている。配列中の文字は、終端の NULL バイト (\(aq\e0\(aq) が出てくるまで出力される (終端文字は出力されない)。
+精度が指定されていると、指定された字数以上は出力されない。 精度が指定された場合には、終端バイトが存在する必要はない。
+精度が指定されていなかったり、精度の値が配列の大きさより大きい場合には、 配列は終端の NULL バイトを含んでいなければならない。
+
+\fBl\fP 修飾子が指定されている場合、 引き数は \fIconst wchar_t *\fP 型でワイド文字の配列へのポインタであることが期待されている。
+配列中のワイド文字は (1文字毎に \fBwcrtomb\fP(3) を呼び出して) マルチバイト文字に変換される (最初のワイド文字の変換の前に
+\fBwcrtomb\fP() のシフト状態を初期状態に戻してから変換は行われる)。 マルチバイト文字への変換は、文字列を終端する NULL ワイド文字が
+出てくるまで行われ、終端 NULL ワイド文字も含めて変換される。 結果のマルチバイト文字列は、終端の NULL バイトが出てくるまで 出力される
+(終端の NULL バイトは出力されない)。 精度が指定された場合、指定されたバイト数以上には出力されない。
+但し、マルチバイト文字の一部分だけが出力されることはない。 精度は「バイト」数を指定するものであり、「ワイド文字」数や
+「画面での位置」を指定するものではないことに注意。 精度が指定されていて、さらに出力が配列の末尾に達する前に出力バイト数が
+精度の値を超える場合だけは、配列は NULL ワイド文字で終端されていなくてもよい。 それ以外の場合は、必ず配列は NULL
+ワイド文字で終端されていなければならない。
+.TP
+\fBC\fP
+(C99 にはないが SUSv2 にはある) \fBlc\fP と同じ。使ってはならない。
+.TP
+\fBS\fP
+(C99 にはないが SUSv2 にはある) \fBls\fP と同じ。使ってはならない。
+.TP
+\fBp\fP
+\fIvoid *\fP ポインタ引き数を (\fB%#x\fP や \fB%#lx\fP のような) 16 進数で出力する。
+.TP
+\fBn\fP
+これまでに出力された文字数を \fIint *\fP (または類似の型) のポインタ引き数が指す整数に保存する。 引き数の変換は行われない。
+.TP
+\fBm\fP
+(glibc での拡張) \fIstrerror(errno)\fP の出力を表示する。引き数は必要ない。
+.TP
+\fB%\fP
+\(aq%\(aq 文字を出力する。変換される引き数は無い。 変換指定全体を書くと "%%" となる。
.SH 準拠
-.BR fprintf (),
-.BR printf (),
-.BR sprintf (),
-.BR vprintf (),
-.BR vfprintf (),
-.BR vsprintf ()
-関数は、C89 と C99 に準拠している。
-.BR snprintf ()
-と
-.BR vsnprintf ()
-は C99 に準拠している。
+\fBfprintf\fP(), \fBprintf\fP(), \fBsprintf\fP(), \fBvprintf\fP(), \fBvfprintf\fP(),
+\fBvsprintf\fP() 関数は、C89 と C99 に準拠している。 \fBsnprintf\fP() と \fBvsnprintf\fP() は C99
+に準拠している。
.PP
-.BR snprintf ()
-の返り値を見ると、
-SUSv2 と C99 標準は互いに矛盾している。
-SUSv2 では、
-.BR snprintf ()
-が
-.IR size =0
-で呼び出された場合、 1 未満の値を何か返り値とするように規定している。
-一方 C99 では、このような場合
-.I str
-を NULL とし、返り値として (通常通り) 出力バッファが十分な大きさが
-あった場合に出力されるであろう文字数を返す。
+\fBsnprintf\fP() の返り値を見ると、 SUSv2 と C99 標準は互いに矛盾している。 SUSv2 では、 \fBsnprintf\fP()
+が \fIsize\fP=0 で呼び出された場合、 1 未満の値を何か返り値とするように規定している。 一方 C99 では、このような場合 \fIstr\fP を
+NULL とし、返り値として (通常通り) 出力バッファが十分な大きさが あった場合に出力されるであろう文字数を返す。
.PP
-Linux libc4 では、 5 つの C 標準のフラグ、
-長さ修飾子 \fBh\fP, \fBl\fP, \fBL\fP、変換
-\fBc\fP, \fBd\fP, \fBe\fP, \fBE\fP, \fBf\fP, \fBF\fP,
-\fBg\fP, \fBG\fP, \fBi\fP, \fBn\fP, \fBo\fP, \fBp\fP,
-\fBs\fP, \fBu\fP, \fBx\fP, \fBX\fP
-が使える。
-但し \fBF\fP は \fBf\fP と同義である。
-また、 \fBD\fP, \fBO\fP, and \fBU\fP を \fBld\fP, \fBlo\fP, and \fBlu\fP
-と同じものとして使える
-(これはまずい仕様で、 後に \fB%D\fP の対応が打ち切られた時に深刻なバグを
-引き起こした)。ロケール依存の小数点、1000 区切り、 NaN と無限、
-"%m$" と "*m$" は使えない。
+Linux libc4 では、 5 つの C 標準のフラグ、 長さ修飾子 \fBh\fP, \fBl\fP, \fBL\fP、変換 \fBc\fP, \fBd\fP, \fBe\fP,
+\fBE\fP, \fBf\fP, \fBF\fP, \fBg\fP, \fBG\fP, \fBi\fP, \fBn\fP, \fBo\fP, \fBp\fP, \fBs\fP, \fBu\fP, \fBx\fP, \fBX\fP
+が使える。 但し \fBF\fP は \fBf\fP と同義である。 また、 \fBD\fP, \fBO\fP, and \fBU\fP を \fBld\fP, \fBlo\fP, and
+\fBlu\fP と同じものとして使える (これはまずい仕様で、 後に \fB%D\fP の対応が打ち切られた時に深刻なバグを
+引き起こした)。ロケール依存の小数点、1000 区切り、 NaN と無限、 "%m$" と "*m$" は使えない。
.PP
-Linux libc5 では、 5 つの C 標準のフラグと \(aq フラグ、ロケール、
-"%m$" と "*m$" が使える。
-また、長さ修飾子 \fBh\fP, \fBl\fP, \fBL\fP, \fBZ\fP, iand \fBq\fP が使えるが、
-\fBL\fP と \fBq\fP は両方とも
-\fIlong double\fP と \fIlong long int\fP に対応している (これはバグである)。
-現在では変換 \fBF\fP, \fBD\fP, \fBO\fP, \fBU\fP は認識されないが、変換文字
-.B m
-が追加された。これは
-.I strerror(errno)
-を出力するものである。
+Linux libc5 では、 5 つの C 標準のフラグと \(aq フラグ、ロケール、 "%m$" と "*m$" が使える。 また、長さ修飾子
+\fBh\fP, \fBl\fP, \fBL\fP, \fBZ\fP, iand \fBq\fP が使えるが、 \fBL\fP と \fBq\fP は両方とも \fIlong double\fP と
+\fIlong long int\fP に対応している (これはバグである)。 現在では変換 \fBF\fP, \fBD\fP, \fBO\fP, \fBU\fP
+は認識されないが、変換文字 \fBm\fP が追加された。これは \fIstrerror(errno)\fP を出力するものである。
.PP
glibc 2.0 では、変換文字 \fBC\fP と \fBS\fP が追加された。
.PP
-glibc 2.1 では、長さ修飾子 \fBhh\fP, \fBj\fP, \fBt\fP, \fBz\fP
-と変換文字 \fBa\fP, \fBA\fP が追加された。
+glibc 2.1 では、長さ修飾子 \fBhh\fP, \fBj\fP, \fBt\fP, \fBz\fP と変換文字 \fBa\fP, \fBA\fP が追加された。
.PP
-glibc 2.2 では、 C99 で規定された意味での変換文字 \fBF\fP と
-フラグ文字 \fBI\fP が追加された。
+glibc 2.2 では、 C99 で規定された意味での変換文字 \fBF\fP と フラグ文字 \fBI\fP が追加された。
.SH 注意
-テキストを
-.I buf
-に追加するのに、軽率にも次のようなコードを使っているプログラムがある。
+テキストを \fIbuf\fP に追加するのに、軽率にも次のようなコードを使っているプログラムがある。
sprintf(buf, "%s some further text", buf);
-しかしながら、標準規格では、
-.BR sprintf (),
-.BR snprintf (),
-.BR vsprintf (),
-.BR vsnprintf ()
-の呼び出しにおいて、コピー元とコピー先のバッファが重なっていた場合の
-結果は不定である、と明記されている。
.\" http://sourceware.org/bugzilla/show_bug.cgi?id=7075
-使用する
-.BR gcc (1)
-のバージョンや指定したコンパイラのオプション次第では、
-上記のような呼び出しで、期待した結果が得られ「ない」ことがある。
+しかしながら、標準規格では、 \fBsprintf\fP(), \fBsnprintf\fP(), \fBvsprintf\fP(), \fBvsnprintf\fP()
+の呼び出しにおいて、コピー元とコピー先のバッファが重なっていた場合の 結果は不定である、と明記されている。 使用する \fBgcc\fP(1)
+のバージョンや指定したコンパイラのオプション次第では、 上記のような呼び出しで、期待した結果が得られ「ない」ことがある。
-glibc の
-.BR snprintf ()
-と
-.BR vsnprintf ()
-の実装は、バージョン 2.1 以降は C99 標準に準拠しており、
-上記の通りの動作をする。
-glibc 2.0.6 までは、出力が切り詰められた場合は \-1 を返す。
-.\" .SH 歴史
-.\" UNIX V7 では
+.\" .SH HISTORY
+.\" UNIX V7 defines the three routines
.\" .BR printf (),
.\" .BR fprintf (),
-.\" .BR sprintf ()
-.\" の 3 つの関数と、フラグ \-、幅と精度での *、長さ修飾子 l、
-.\" 変換 doxfegcsu、そして ld,ld,lu,lx の同義語として D,O,U,X が定義されている。
-.\" 2.9.1BSD でもこれは同じだったが、 2.10BSD では
-.\" フラグ #, +, 空白が追加され、 D,O,U,X については記載されなくなった。
-.\" 2.11BSD では
+.\" .BR sprintf (),
+.\" and has the flag \-, the width or precision *, the length modifier l,
+.\" and the conversions doxfegcsu, and also D,O,U,X as synonyms for ld,lo,lu,lx.
+.\" This is still true for 2.9.1BSD, but 2.10BSD has the flags
+.\" #, + and <space> and no longer mentions D,O,U,X.
+.\" 2.11BSD has
.\" .BR vprintf (),
.\" .BR vfprintf (),
-.\" .BR vsprintf ()
-.\" が追加され、 D,O,U,X を使わないように警告された。
-.\" 4.3BSD Reno ではフラグ 0、長さ修飾子 h と L、
-.\" 変換 n, p, E, G, (現在の意味での) X が追加され、
-.\" D,O,U は非推奨扱いとなった。
-.\" 4.4BSD では、関数
-.\" .BR snprintf ()と
-.\" .BR vsnprintf ()、
-.\" 長さ修飾子 q が導入された。
-.\" FreeBSD では、
-.\" .BR sprintf ()
-.\" のために十分なバッファを確保する
+.\" .BR vsprintf (),
+.\" and warns not to use D,O,U,X.
+.\" 4.3BSD Reno has the flag 0, the length modifiers h and L,
+.\" and the conversions n, p, E, G, X (with current meaning)
+.\" and deprecates D,O,U.
+.\" 4.4BSD introduces the functions
+.\" .BR snprintf ()
+.\" and
+.\" .BR vsnprintf (),
+.\" and the length modifier q.
+.\" FreeBSD also has functions
.\" .BR asprintf ()
-.\" と
-.\" .BR vasprintf ()
-.\" が追加されている。
-.\" glibc には、関数
-.\" .BR dprintf (),
+.\" and
+.\" .BR vasprintf (),
+.\" that allocate a buffer large enough for
+.\" .BR sprintf ().
+.\" In glibc there are functions
+.\" .BR dprintf ()
+.\" and
.\" .BR vdprintf ()
-.\" があり、これらはストリームではなくファイルディスクリプタに出力する。
+.\" that print to a file descriptor instead of a stream.
+glibc の \fBsnprintf\fP() と \fBvsnprintf\fP() の実装は、バージョン 2.1 以降は C99 標準に準拠しており、
+上記の通りの動作をする。 glibc 2.0.6 までは、出力が切り詰められた場合は \-1 を返す。
.SH バグ
-.BR sprintf ()
-と
-.BR vsprintf ()
-は勝手に十分に長い文字列領域があると仮定するので、呼び出し側は
-実際の領域からあふれないように注意しなければならない。
-しかし、これを保証することが不可能な場合が多い。
-生成される文字列の長さはロケール依存であり、予測が難しいことに注意。
-代わりに
-.BR snprintf ()
-と
-.BR vsnprintf ()
-(または
-.BR asprintf (3)
-と
-.BR vasprintf (3))
-を使うこと。
+\fBsprintf\fP() と \fBvsprintf\fP() は勝手に十分に長い文字列領域があると仮定するので、呼び出し側は
+実際の領域からあふれないように注意しなければならない。 しかし、これを保証することが不可能な場合が多い。
+生成される文字列の長さはロケール依存であり、予測が難しいことに注意。 代わりに \fBsnprintf\fP() と \fBvsnprintf\fP()
+(または \fBasprintf\fP(3) と \fBvasprintf\fP(3)) を使うこと。
.PP
-Linux libc4.[45] には
-.BR snprintf ()
-はないが、 libbsd が提供されており、
-その中には
-.BR sprintf ()
-と等価な (つまり
-.I size
-引き数を無視する)
-.BR snprintf ()
-がある。
-したがって、初期の libc4 で
-.BR snprintf ()
-を使うと、深刻なセキュリティ問題を引き起こすことがある。
+Linux libc4.[45] には \fBsnprintf\fP() はないが、 libbsd が提供されており、 その中には \fBsprintf\fP()
+と等価な (つまり \fIsize\fP 引き数を無視する) \fBsnprintf\fP() がある。 したがって、初期の libc4 で
+\fBsnprintf\fP() を使うと、深刻なセキュリティ問題を引き起こすことがある。
.PP
-.BI printf( foo );
-のようなコードはしばしばバグを引き起こす。
-なぜなら
-.I foo
-に % 文字が含まれてるかもしれないからである。
-.I foo
-が信頼できないユーザー入力から作られている場合には、
-その中に \fB%n\fP が含まれていることがあり、
-.BR printf ()
-呼び出し時にメモリへの書き込みが起こり、
-セキュリティーホールを作ることになるかもしれない。
-.\".PP
-.\".\"O Some floating-point conversions under early libc4
-.\".\"O caused memory leaks.
-.\"初期の libc4 での実数変換にはメモリリークを引き起こすことがある。
+.\" .PP
+.\" Some floating-point conversions under early libc4
+.\" caused memory leaks.
+\fBprintf(\fP\fIfoo\fP\fB);\fP のようなコードはしばしばバグを引き起こす。 なぜなら \fIfoo\fP に %
+文字が含まれてるかもしれないからである。 \fIfoo\fP が信頼できないユーザー入力から作られている場合には、 その中に \fB%n\fP
+が含まれていることがあり、 \fBprintf\fP() 呼び出し時にメモリへの書き込みが起こり、 セキュリティーホールを作ることになるかもしれない。
.SH 例
-.if \w'\*(Pi'=0 .ds Pi pi
+.if \w'\*(Pi'=0 .ds Pi pi
\*(Pi を 5 桁で出力する。
.in +4n
.nf
.fi
.in
.PP
-日付と時間を "Sunday, July 3, 10:02" の形式で出力する。
-.RI ( weekday
-と
-.I month
+日付と時間を "Sunday, July 3, 10:02" の形式で出力する。 (\fIweekday\fP と \fImonth\fP
は文字列へのポインタである)
.in +4n
.nf
.fi
.in
.PP
-日 - 月 - 年 の順序で表示を行う国も多い。
-従って、国際版では書式で指定された順番で
-引き数を表示できなければならない。
+日 \- 月 \- 年 の順序で表示を行う国も多い。 従って、国際版では書式で指定された順番で 引き数を表示できなければならない。
.in +4n
.nf
.fi
.in
-.I format
-はロケールに依存しており、引き数の順番を変えることもできる。
-.I format
-が
+\fIformat\fP はロケールに依存しており、引き数の順番を変えることもできる。 \fIformat\fP が
.in +4n
.nf
.in
であれば、 "Sonntag, 3. Juli, 10:02" という結果になる。
.PP
-十分に大きな文字列領域を確保して、そこにメッセージを格納するには
-(glibc 2.0 と glibc 2.1 の両方で正しく動作するコード):
+十分に大きな文字列領域を確保して、そこにメッセージを格納するには (glibc 2.0 と glibc 2.1 の両方で正しく動作するコード):
.nf
#include <stdio.h>
#include <stdlib.h>
#include <stdarg.h>
+
char *
make_message(const char *fmt, ...)
{
}
.fi
.SH 関連項目
-.BR printf (1),
-.BR asprintf (3),
-.BR dprintf (3),
-.BR scanf (3),
-.BR setlocale (3),
-.BR wcrtomb (3),
-.BR wprintf (3),
-.BR locale (5)
+\fBprintf\fP(1), \fBasprintf\fP(3), \fBdprintf\fP(3), \fBscanf\fP(3), \fBsetlocale\fP(3),
+\fBwcrtomb\fP(3), \fBwprintf\fP(3), \fBlocale\fP(5)
OSDN Git Service
