.\" 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"
-.\"O .SH NAME
+.\"*******************************************************************
+.TH PRINTF 3 2011\-09\-28 GNU "Linux Programmer's Manual"
.SH 名前
-.\"O printf, fprintf, sprintf, snprintf, vprintf, vfprintf, vsprintf,
-.\"O vsnprintf \- formatted output conversion
-printf, fprintf, sprintf, snprintf, vprintf, vfprintf, vsprintf,
-vsnprintf \- 指定された書式に変換して出力を行う
-.\"O .SH SYNOPSIS
+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
-.\"O Feature Test Macro Requirements for glibc (see
-.\"O .BR feature_test_macros (7)):
-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
-.\"O .SH DESCRIPTION
.SH 説明
-.\"O The functions in the
-.\"O .BR printf ()
-.\"O family produce output according to a
-.\"O .I format
-.\"O as described below.
-.BR printf ()
-関数グループは、以下で述べるように、
-.I format
-に従って出力を生成するものである。
-.\"O The functions
-.\"O .BR printf ()
-.\"O and
-.\"O .BR vprintf ()
-.\"O write output to
-.\"O .IR stdout ,
-.\"O the standard output stream;
-.\"O .BR fprintf ()
-.\"O and
-.\"O .BR vfprintf ()
-.\"O write output to the given output
-.\"O .IR stream ;
-.\"O .BR sprintf (),
-.\"O .BR snprintf (),
-.\"O .BR vsprintf ()
-.\"O and
-.\"O .BR vsnprintf ()
-.\"O write to the character string
-.\"O .IR str .
-.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
-.\"O The functions
-.\"O .BR snprintf ()
-.\"O and
-.\"O .BR vsnprintf ()
-.\"O write at most
-.\"O .I size
-.\"O bytes (including the terminating null byte (\(aq\e0\(aq)) to
-.\"O .IR str .
-.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
-.\"O The functions
-.\"O .BR vprintf (),
-.\"O .BR vfprintf (),
-.\"O .BR vsprintf (),
-.\"O .BR vsnprintf ()
-.\"O are equivalent to the functions
-.\"O .BR printf (),
-.\"O .BR fprintf (),
-.\"O .BR sprintf (),
-.\"O .BR snprintf (),
-.\"O respectively, except that they are called with a
-.\"O .I va_list
-.\"O instead of a variable number of arguments.
-.\"O These functions do not call the
-.\"O .I va_end
-.\"O macro.
-.\"O Because they invoke the
-.\"O .I va_arg
-.\"O macro, the value of
-.\"O .I ap
-.\"O is undefined after the call.
-.\"O See
-.\"O .BR stdarg (3).
-.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
-.\"O These eight functions write the output under the control of a
-.\"O .I format
-.\"O string that specifies how subsequent arguments (or arguments accessed via
-.\"O the variable-length argument facilities of
-.\"O .BR stdarg (3))
-.\"O are converted for output.
-これらの 8 つの関数は
-.I format
-文字列の制御に従って出力を書き出す。
-.I format
-文字列は、これに続く引き数 (または
-.BR stdarg (3)
-の可変長引き数機構を使ってアクセスできる引き数)
-をどのように変換して出力するかを指定する。
+これらの 8 つの関数は \fIformat\fP 文字列の制御に従って出力を書き出す。 \fIformat\fP 文字列は、これに続く引き数 (または
+\fBstdarg\fP(3) の可変長引き数機構を使ってアクセスできる引き数) をどのように変換して出力するかを指定する。
-.\"O C99 and POSIX.1-2001 specify that the results are undefined if a call to
-.\"O .BR sprintf (),
-.\"O .BR snprintf (),
-.\"O .BR vsprintf (),
-.\"O or
-.\"O .BR vsnprintf ()
-.\"O would cause copying to take place between objects that overlap
-.\"O (e.g., if the target string array and one of the supplied input arguments
-.\"O refer to the same buffer).
-.\"O See NOTES.
-C99 と POSIX.1-2001 では、
-.BR sprintf (),
-.BR snprintf (),
-.BR vsprintf (),
-.BR vsnprintf ()
-の呼び出しで、範囲が重複するオブジェクト間でコピーが発生する場合の
-結果は不定であると規定されている (例えば、出力先の文字列と入力された
-引き数の一つが同じバッファを参照している場合などである)。
-「注意」の節を参照。
-.\"O .SS "Return value"
-.SS 返り値
-.\"O Upon successful return, these functions return the number of characters
-.\"O printed (excluding the null byte used to end output to strings).
-成功時には、上記の関数は書き込まれた文字数を返す
-(文字列の最後を示すために使用する NULL バイトは数に含まれない)。
+C99 と POSIX.1\-2001 では、 \fBsprintf\fP(), \fBsnprintf\fP(), \fBvsprintf\fP(),
+\fBvsnprintf\fP() の呼び出しで、範囲が重複するオブジェクト間でコピーが発生する場合の 結果は不定であると規定されている
+(例えば、出力先の文字列と入力された 引き数の一つが同じバッファを参照している場合などである)。 「注意」の節を参照。
+.SS "Return Values"
+成功時には、上記の関数は書き込まれた文字数を返す (文字列の最後を示すために使用する NULL バイトは数に含まれない)。
-.\"O The functions
-.\"O .BR snprintf ()
-.\"O and
-.\"O .BR vsnprintf ()
-.\"O do not write more than
-.\"O .I size
-.\"O bytes (including the terminating null byte (\(aq\e0\(aq)).
-.\"O If the output was truncated due to this limit then the return value
-.\"O is the number of characters (excluding the terminating null byte)
-.\"O which would have been written to the final string if enough space
-.\"O had been available.
-.\"O Thus, a return value of
-.\"O .I size
-.\"O or more means that the output was truncated.
-.\"O (See also below under NOTES.)
-.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
+以上だった場合、出力が切り詰められたことを意味する (後述の注意も参照のこと)。
-.\"O If an output error is encountered, a negative value is returned.
エラーが発生した場合は、負の数を返す。
-.\"O .SS "Format of the format string"
.SS フォーマット文字列のフォーマット
-.\"O The format string is a character string, beginning and ending
-.\"O in its initial shift state, if any.
-フォーマット文字列は文字の列で、
-(もしあるなら) 初期シフト状態で始まり、初期シフト状態で終わる。
-.\"O The format string is composed of zero or more directives: ordinary
-.\"O characters (not
-.\"O .BR % ),
-.\"O which are copied unchanged to the output stream;
-.\"O and conversion specifications, each of which results in fetching zero or
-.\"O more subsequent arguments.
-フォーマット用の文字列は 0 個以上の命令 (directives) によって構成される。
-命令には、通常文字と変換指定 (conversion specifications) がある。
-通常文字は
-.B %
-以外の文字で、出力ストリームにそのままコピーされる。
-変換指定は、それぞれが 0 個以上の引き数を取る。
-.\"O Each conversion specification is introduced by
-.\"O the character
-.\"O .BR % ,
-.\"O and ends with a
-.\"O .IR "conversion specifier" .
-各変換指定は文字
-.B %
-で始まり、
-.I "変換指定子 (conversion specifier)"
-で終わる。
-.\"O In between there may be (in this order) zero or more
-.\"O .IR flags ,
-.\"O an optional minimum
-.\"O .IR "field width" ,
-.\"O an optional
-.\"O .I precision
-.\"O and an optional
-.\"O .IR "length modifier" .
-.B %
-と変換指定子の間には、0 個以上の
-.I フラグ 、
-最小
-.I フィールド幅 、
-.I 精度 、
-.I 長さ修飾子
-を (この順序で) 置くことができる。
-
-.\"O The arguments must correspond properly (after type promotion) with the
-.\"O conversion specifier.
-.\"O By default, the arguments are used in the order
-.\"O given, where each \(aq*\(aq and each conversion specifier asks for the next
-.\"O argument (and it is an error if insufficiently many arguments are given).
-引き数は (型の格上げの後は) 変換指定子が表す型と正確に対応しなければならない。
-デフォルトでは、\(aq*\(aq や変換指定子が出てくる毎に次の引き数を要求され、
-引き数は指定された順序で使用されていく
-(指定された引き数の個数が不十分ならエラーとなる)。
-.\"O One can also specify explicitly which argument is taken,
-.\"O at each place where an argument is required, by writing "%m$" instead
-.\"O of \(aq%\(aq and "*m$" instead of \(aq*\(aq,
-.\"O where the decimal integer m denotes
-.\"O the position in the argument list of the desired argument, indexed starting
-.\"O from 1.
-.\"O Thus,
-.\"O .in +4n
-.\"O .nf
-.\"O
-.\"O printf("%*d", width, num);
-.\"O
-.\"O .fi
-.\"O .in
-.\"O and
-.\"O .in +4n
-.\"O .nf
-.\"O
-.\"O printf("%2$*1$d", width, num);
-.\"O
-.\"O .fi
-.\"O .in
-また、引き数が必要な箇所で \(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
-は等価である。
-.\"O are equivalent.
-.\"O The second style allows repeated references to the
-.\"O same argument.
-.\"O The C99 standard does not include the style using \(aq$\(aq,
-.\"O which comes from the Single UNIX Specification.
-.\"O If the style using
-.\"O \(aq$\(aq is used, it must be used throughout for all conversions taking an
-.\"O argument and all width and precision arguments, but it may be mixed
-.\"O with "%%" formats which do not consume an argument.
-.\"O There may be no
-.\"O gaps in the numbers of arguments specified using \(aq$\(aq; for example, if
-.\"O arguments 1 and 3 are specified, argument 2 must also be specified
-.\"O somewhere in the format string.
-二番目の書き方では同じ引き数を繰り返し参照することができる。
-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 もフォーマット文字列のどこかで
指定されなければならない。
-.\"O For some numeric conversion a radix character ("decimal point") or
-.\"O thousands' grouping character is used.
-.\"O The actual character used
-.\"O depends on the
-.\"O .B LC_NUMERIC
-.\"O part of the locale.
-.\"O The POSIX locale
-.\"O uses \(aq.\(aq as radix character, and does not have a grouping character.
-数値変換には小数点や 1000 単位の区切り文字を使うものもある。
-実際にどの文字を使うかはロケールの
-.B LC_NUMERIC
-による。
-POSIX ロケールでは小数点に \(aq.\(aq を用い、
-区切り文字は使わない。
-.\"O Thus,
-従って、
+数値変換には小数点や 1000 単位の区切り文字を使うものもある。 実際にどの文字を使うかはロケールの \fBLC_NUMERIC\fP による。 POSIX
+ロケールでは小数点に \(aq.\(aq を用い、 区切り文字は使わない。 従って、
.in +4n
.nf
.fi
.in
-.\"O results in "1234567.89" in the POSIX locale, in "1234567,89" in the
-.\"O nl_NL locale, and in "1.234.567,89" in the da_DK locale.
-は、 POSIX ロケールでは "1234567.89" 、 nl_NL ロケールでは "1234567,89"、
-da_DK ロケールでは "1.234.567,89" となる。
-.\"O .SS "The flag characters"
+は、 POSIX ロケールでは "1234567.89" 、 nl_NL ロケールでは "1234567,89"、 da_DK ロケールでは
+"1.234.567,89" となる。
.SS フラグ文字
-.\"O The character % is followed by zero or more of the following flags:
% 文字の後ろには 0 個以上のフラグ文字が続く。
-.TP
-.\"O .B #
-.\"O The value should be converted to an "alternate form".
-.B #
-値は「別の形式」に変換される。
-.\"O For
-.\"O .B o
-.\"O conversions, the first character of the output string is made zero
-.\"O (by prefixing a 0 if it was not zero already).
-.B o
-変換の場合、(先頭文字が 0 になっていない場合に先頭に 0 を追加することで)
-出力文字列の最初の文字を 0 にする。
-.\"O For
-.\"O .B x
-.\"O and
-.\"O .B X
-.\"O conversions, a nonzero result has the string "0x" (or "0X" for
-.\"O .B X
-.\"O conversions) prepended to it.
-.B x
-と
-.B X
-変換の場合、数値が 0 でないときには文字列 "0x"
-.RB ( X
-変換の場合には "0X") が前に付与される。
-.\"O For
-.\"O .BR a ,
-.\"O .BR A ,
-.\"O .BR e ,
-.\"O .BR E ,
-.\"O .BR f ,
-.\"O .BR F ,
-.\"O .BR g ,
-.\"O and
-.\"O .B G
-.\"O conversions, the result will always contain a decimal point, even if no
-.\"O digits follow it (normally, a decimal point appears in the results of those
-.\"O conversions only if a digit follows).
-.\"O For
-.BR a ,
-.BR A ,
-.BR e ,
-.BR E ,
-.BR f ,
-.BR F ,
-.BR g ,
-.B G
-変換では、 小数点に続く数字がなくても、
-出力には常に小数点が含まれる
-(通常は、小数点の後に数字が続く場合にのみ、
-小数点が表示される)。
-.\"O .B g
-.\"O and
-.\"O .B G
-.\"O conversions, trailing zeros are not removed from the result as they would
-.\"O otherwise be.
-.B g
-と
-.B G
-変換の場合、他の変換とは異なり、末尾のゼロが変換結果から削除されない。
-.\"O For other conversions, the result is undefined.
-その他の変換では、結果は未定義である。
-.TP
-.B \&0
-.\"O The value should be zero padded.
-.\"O For
-.\"O .BR d ,
-.\"O .BR i ,
-.\"O .BR o ,
-.\"O .BR u ,
-.\"O .BR x ,
-.\"O .BR X ,
-.\"O .BR a ,
-.\"O .BR A ,
-.\"O .BR e ,
-.\"O .BR E ,
-.\"O .BR f ,
-.\"O .BR F ,
-.\"O .BR g ,
-.\"O and
-.\"O .B G
-.\"O conversions, the converted value is padded on the left with zeros rather
-.\"O than blanks.
-値をゼロで埋める。
-.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
-変換では、変換した値の左側を空白文字の代わりにゼロで埋める。
-.\"O If the
-.\"O .B \&0
-.\"O and
-.\"O .B \-
-.\"O flags both appear, the
-.\"O .B \&0
-.\"O flag is ignored.
-.B \&0
-と
-.B \-
-が両方とも指定された場合は、
-.B \&0
-フラグは無視される。
-.\"O If a precision is given with a numeric conversion
-.\"O .RB ( d ,
-.\"O .BR i ,
-.\"O .BR o ,
-.\"O .BR u ,
-.\"O .BR x ,
-.\"O and
-.\"O .BR X ),
-.\"O the
-.\"O .B \&0
-.\"O flag is ignored.
-精度が数値変換
-.RB ( d ,
-.BR i ,
-.BR o ,
-.BR u ,
-.BR x ,
-.BR X )
-と同時に指定された場合には、
-.B \&0
-フラグは無視される。
-.\"O For other conversions, the behavior is undefined.
-その他の変換では、動作は未定義である。
-.TP
-.B \-
-.\"O The converted value is to be left adjusted on the field boundary.
-.\"O (The default is right justification.)
-.\"O Except for
-.\"O .B n
-.\"O conversions, the converted value is padded on the right with blanks, rather
-.\"O than on the left with blanks or zeros.
-.\"O A
-変換値をフィールド境界で左揃えにする
-(デフォルトは右揃えである)。
-.B n
-変換以外では、変換された値は
-左側ではなく右側を空白文字やゼロで埋められる。
-.\"O .B \-
-.\"O overrides a
-.\"O .B \&0
-.\"O if both are given.
-.B \-
-と
-.B \&0
-の両方が指定された場合には、
-.B \-
-が優先される。
-.TP
-.\"O .B \(aq \(aq
-.B ' '
-.\"O (a space) A blank should be left before a positive number
-.\"O (or empty string) produced by a signed conversion.
-(1個の半角スペース)
-符号付き変換で生成された正の数字の前に空白 (または空文字列) が置かれる。
-.TP
-.\"O .B +
-.\"O A sign (+ or \-) should always be placed before a number produced by a signed
-.\"O conversion.
-.\"O By default a sign is used only for negative numbers.
-.\"O A
-.\"O .B +
-.\"O overrides a space if both are used.
-.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
-.\"O The five flag characters above are defined in the C standard.
-.\"O The SUSv2 specifies one further flag character.
-上記の 5 つのフラグは C 標準で定義されている。
-SUSv2 では、さらにもう一つフラグ文字が規定されている。
-.TP
-.B \(aq
-.\"O For decimal conversion
-.\"O .RB ( i ,
-.\"O .BR d ,
-.\"O .BR u ,
-.\"O .BR f ,
-.\"O .BR F ,
-.\"O .BR g ,
-.\"O .BR G )
-.\"O the output is to be grouped with thousands' grouping characters
-.\"O if the locale information indicates any.
-.\"O Note that many versions of
-.\"O .BR gcc (1)
-.\"O cannot parse this option and will issue a warning.
-.\"O SUSv2 does not
-.\"O include %\(aqF.
-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
-.\"O glibc 2.2 adds one further flag character.
glibc 2.2 では、さらに一つフラグ文字が追加されている。
-.TP
-.B I
-.\"O For decimal integer conversion
-.\"O .RB ( i ,
-.\"O .BR d ,
-.\"O .BR u )
-.\"O the output uses the locale's alternative output digits, if any.
-.\"O For example, since glibc 2.2.3 this will give Arabic-Indic digits
-.\"O in the Persian ("fa_IR") locale.
-.\"O .\" outdigits keyword in locale file
-10進整数変換
-.RB ( i ,
-.BR d ,
-.BR u )
-において、ロケールの代替出力数字があれば、それを用いて出力する。
-例えば、 glibc 2.2.3 以降では、ペルシア ("fa_IR") ロケールで
-アラビア数字 (Arabic-Indic digits) を出力できる。
-.\" ロケールファイルには outdigits というキーワードがある。
-.\"O .SS "The field width"
+.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 フィールド幅
-.\"O An optional decimal digit string (with nonzero first digit) specifying
-.\"O a minimum field width.
-.\"O If the converted value has fewer characters
-.\"O than the field width, it will be padded with spaces on the left
-.\"O (or right, if the left-adjustment flag has been given).
-最小のフィールド幅を指定する 10進数の数値文字列 (文字列の最初の文字は
-ゼロ以外)。本項目はオプションである。
-変換された値の文字数がフィールド長よりも少ない場合、
-フィールドの左側をスペースで埋める
-(左揃えのフラグがある場合は右側を埋める)。
-.\"O Instead of a decimal digit string one may write "*" or "*m$"
-.\"O (for some decimal integer \fIm\fP) to specify that the field width
-.\"O is given in the next argument, or in the \fIm\fP-th argument, respectively,
-.\"O which must be of type
-.\"O .IR int .
-10進数の文字列の代わりに "*" や "*m$" (\fIm\fP は 10進整数) を書くこともできる。
-"*" と "*m$" はそれぞれ、次の引き数と \fIm\fP 番目の引き数をフィールド幅として
-使うことを指定する (これらの引き数は
-.I int
-型でなければならない)。
-.\"O A negative field width is taken as a \(aq\-\(aq flag followed by a
-.\"O positive field width.
-フィールド幅に負の数が指定された場合は、
-\(aq\-\(aq フラグと正の数のフィールド幅として扱われる。
-.\"O In no case does a nonexistent or small field width cause truncation of a
-.\"O field; if the result of a conversion is wider than the field width, the
-.\"O field is expanded to contain the conversion result.
-フィールド幅が小さかったり指定がなかったりしても、フィールドが切り詰められる
-ことはない。もし変換結果がフィールド幅よりも広かった場合、
+最小のフィールド幅を指定する 10進数の数値文字列 (文字列の最初の文字は ゼロ以外)。本項目はオプションである。
+変換された値の文字数がフィールド長よりも少ない場合、 フィールドの左側をスペースで埋める (左揃えのフラグがある場合は右側を埋める)。
+10進数の文字列の代わりに "*" や "*m$" (\fIm\fP は 10進整数) を書くこともできる。 "*" と "*m$" はそれぞれ、次の引き数と
+\fIm\fP 番目の引き数をフィールド幅として 使うことを指定する (これらの引き数は \fIint\fP 型でなければならない)。
+フィールド幅に負の数が指定された場合は、 \(aq\-\(aq フラグと正の数のフィールド幅として扱われる。
+フィールド幅が小さかったり指定がなかったりしても、フィールドが切り詰められる ことはない。もし変換結果がフィールド幅よりも広かった場合、
フィールドは変換結果が入る幅に広げられる。
-.\"O .SS "The precision"
.SS 精度
-.\"O An optional precision, in the form of a period (\(aq.\(aq) followed by an
-.\"O optional decimal digit string.
-オプションである精度は、ピリオド (\(aq.\(aq) とそれに続く10進数という
-形式で指定する (10進数はオプション) 。
-.\"O Instead of a decimal digit string one may write "*" or "*m$"
-.\"O (for some decimal integer m) to specify that the precision
-.\"O is given in the next argument, or in the m-th argument, respectively,
-.\"O which must be of type
-.\"O .IR int .
-10進数の文字列の代わりに "*" や "*m$" (m は 10 進整数)を書くこともできる。
-"*" と "*m$" はそれぞれ、次の引き数と m 番目の引き数を精度として
-使うことを指定する (これらの引き数は
-.I int
-型でなければならない)。
-.\"O If the precision is given as just \(aq.\(aq, or the precision is negative,
-.\"O the precision is taken to be zero.
-精度として \(aq.\(aq だけが指定されたり、精度が負の数だった場合、
-精度はゼロとみなされる。
-.\"O This gives the minimum number of digits to appear for
-.\"O .BR d ,
-.\"O .BR i ,
-.\"O .BR o ,
-.\"O .BR u ,
-.\"O .BR x ,
-.\"O and
-.\"O .B X
-.\"O conversions, the number of digits to appear after the radix character for
-.\"O .BR a ,
-.\"O .BR A ,
-.\"O .BR e ,
-.\"O .BR E ,
-.\"O .BR f ,
-.\"O and
-.\"O .B F
-.\"O conversions, the maximum number of significant digits for
-.\"O .B g
-.\"O and
-.\"O .B G
-.\"O conversions, or the maximum number of characters to be printed from a
-.\"O string for
-.\"O .B s
-.\"O and
-.\"O .B S
-.\"O conversions.
-.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
変換では、文字列から出力される最大文字数を指定する。
-.\"O .SS "The length modifier"
.SS 長さ修飾子
-.\"O Here, "integer conversion" stands for
-.\"O .BR d ,
-.\"O .BR i ,
-.\"O .BR o ,
-.\"O .BR u ,
-.\"O .BR x ,
-.\"O or
-.\"O .B X
-.\"O conversion.
-「整数変換」とは、
-.BR d ,
-.BR i ,
-.BR o ,
-.BR u ,
-.BR x ,
-.B X
-変換のことである。
-.TP
-.B hh
-.\"O A following integer conversion corresponds to a
-.\"O .I signed char
-.\"O or
-.\"O .I unsigned char
-.\"O argument, or a following
-.\"O .B n
-.\"O conversion corresponds to a pointer to a
-.\"O .I signed char
-.\"O argument.
-整数変換に対応する引き数が
-.I signed char
-か
-.I unsigned char
-で、
-.B n
-変換に対応する引き数が
-.I signed char
-へのポインタであることを示す。
-.TP
-.B h
-.\"O A following integer conversion corresponds to a
-.\"O .I short int
-.\"O or
-.\"O .I unsigned short int
-.\"O argument, or a following
-.\"O .B n
-.\"O conversion corresponds to a pointer to a
-.\"O .I short int
-.\"O argument.
-整数変換に対応する引き数が
-.I short int
-か
-.I unsigned short int
-で、
-.B n
-変換に対応する引き数が
-.I short int
-へのポインタであることを示す。
-.TP
-.\"O .B l
-.\"O (ell) A following integer conversion corresponds to a
-.\"O .I long int
-.\"O or
-.\"O .I unsigned long int
-.\"O argument, or a following
-.\"O .B n
-.\"O conversion corresponds to a pointer to a
-.\"O .I long long int
-.\"O argument, or a following
-.\"O .B c
-.\"O conversion corresponds to a
-.\"O .I wint_t
-.\"O argument, or a following
-.\"O .B s
-.\"O conversion corresponds to a pointer to
-.\"O .I wchar_t
-.\"O argument.
-.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
-.\"O .B ll
-.\"O (ell-ell).
-.\"O A following integer conversion corresponds to a
-.\"O .I long long int
-.\"O or
-.\"O .I unsigned long long int
-.\"O argument, or a following
-.\"O .B n
-.\"O conversion corresponds to a pointer to a
-.\"O .I long int
-.\"O argument.
-.BR ll " (エルエル)"
-整数変換に対応する引き数が
-.I long long int
-か
-.I unsigned long long int
-で、
-.B n
-変換に対応する引き数が
-.I long int
-へのポインタであることを示す。
-.TP
-.B L
-.\"O A following
-.\"O .BR a ,
-.\"O .BR A ,
-.\"O .BR e ,
-.\"O .BR E ,
-.\"O .BR f ,
-.\"O .BR F ,
-.\"O .BR g ,
-.\"O or
-.\"O .B G
-.\"O conversion corresponds to a
-.\"O .I long double
-.\"O argument.
-.BR a ,
-.BR A ,
-.BR e ,
-.BR E ,
-.BR f ,
-.BR F ,
-.BR g ,
-.B G
-変換に対応する引き数が
-.I long double
-であることを示す。
-.\"O (C99 allows %LF, but SUSv2 does not.)
-(C99 では %LF を使うことを認めているが、SUSv2 では認められていない。)
-.TP
-.B q
-.\"O ("quad". 4.4BSD and Linux libc5 only.
-.\"O Don't use.)
-.\"O This is a synonym for
-.\"O .BR ll .
-("quad"。 4.4BSD と Linux libc5 のみ有効。使ってはならない。)
-.B ll
-と同じ意味である。
-.TP
-.B j
-.\"O A following integer conversion corresponds to an
-.\"O .I intmax_t
-.\"O or
-.\"O .I uintmax_t
-.\"O argument.
-整数変換に対応する引き数が
-.I intmax_t
-か
-.I uintmax_t
-であることを示す。
-.TP
-.B z
-.\"O A following integer conversion corresponds to a
-.\"O .I size_t
-.\"O or
-.\"O .I ssize_t
-.\"O argument.
-.\"O (Linux libc5 has
-.\"O .B Z
-.\"O with this meaning.
-.\"O Don't use it.)
-整数変換に対応する引き数が
-.I size_t
-か
-.I ssize_t
-であることを示す。
-(Linux libc5 では、これを指定するのに
-.B Z
-を用いる。使ってはならない。)
-.TP
-.B t
-.\"O A following integer conversion corresponds to a
-.\"O .I ptrdiff_t
-.\"O argument.
-整数変換に対応する引き数が
-.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
-.\"O The SUSv2 only knows about the length modifiers
-.\"O .B h
-.\"O (in
-.\"O .BR hd ,
-.\"O .BR hi ,
-.\"O .BR ho ,
-.\"O .BR hx ,
-.\"O .BR hX ,
-.\"O .BR hn )
-.\"O and
-.\"O .B l
-.\"O (in
-.\"O .BR ld ,
-.\"O .BR li ,
-.\"O .BR lo ,
-.\"O .BR lx ,
-.\"O .BR lX ,
-.\"O .BR ln ,
-.\"O .BR lc ,
-.\"O .BR ls )
-.\"O and
-.\"O .B L
-.\"O (in
-.\"O .BR Le ,
-.\"O .BR LE ,
-.\"O .BR Lf ,
-.\"O .BR Lg ,
-.\"O .BR LG ).
-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 )
-だけである。
-.\"O .SS "The conversion specifier"
+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 変換指定子
-.\"O A character that specifies the type of conversion to be applied.
-適用される変換の型を指定する文字。
-.PP
-.\"O The conversion specifiers and their meanings are:
-変換指定子とその意味は以下の通りである。
-.TP
-.BR d ", " i
-.\"O The
-.\"O .I int
-.\"O argument is converted to signed decimal notation.
-.I int
-引き数を符号付き 10 進表記に変換する。
-.\"O The precision, if any, gives the minimum number of digits
-.\"O that must appear; if the converted value requires fewer digits, it is
-.\"O padded on the left with zeros.
-.\"O The default precision is 1.
-精度指定があれば、精度で指定した桁数は必ず出力される。変換後の値が
-指定された桁数に足りない場合は、左側が 0 で埋められる。
-デフォルトの精度は 1 である。
-.\"O When 0 is printed with an explicit precision 0, the output is empty.
-0 を表示しようとした時に、明示的に精度として 0 が指定されていると、
-出力は空文字列となる。
-.TP
-.BR o ", " u ", " x ", " X
-.\"O The
-.\"O .I "unsigned int"
-.\"O argument is converted to unsigned octal
-.\"O .RB ( o ),
-.\"O unsigned decimal
-.\"O .RB ( u ),
-.\"O or unsigned hexadecimal
-.\"O .RB ( x
-.\"O and
-.\"O .BR X )
-.\"O notation.
-.I "unsigned int"
-引き数を、
-符号なし8進数
-.RB ( o ),
-符号なし10進数
-.RB ( u ),
-符号なし16進数
-.RB ( x
-と
-.BR X )
-に変換する。
-.\"O The letters
-.\"O .B abcdef
-.\"O are used for
-.\"O .B x
-.\"O conversions; the letters
-.\"O .B ABCDEF
-.\"O are used for
-.\"O .B X
-.\"O conversions.
-.B x
-変換では
-.B abcdef
-が使用され、
-.B X
-変換では
-.B ABCDEF
-が使用される。
-.\"O The precision, if any, gives the minimum number of digits
-.\"O that must appear; if the converted value requires fewer digits, it is
-.\"O padded on the left with zeros.
-精度指定があれば、精度で指定した桁数は必ず出力される。変換後の値が
-指定された桁数に足りない場合は、左側が 0 で埋められる。
-.TP
-.BR e ", " E
-.\"O The
-.\"O .I double
-.\"O argument is rounded and converted in the style
-.\"O .if \w'\*(Pm'=0 .ds Pm \(+-
-.\"O .RB [\-]d \&. ddd e \\*(Pmdd
-.\"O where there is one digit before the decimal-point character and the number
-.\"O of digits after it is equal to the precision; if the precision is missing,
-.\"O it is taken as 6; if the precision is zero, no decimal-point character
-.\"O appears.
-.\"O An
-.I double
-引き数を丸めて
-.if \w'\*(Pm'=0 .ds Pm \(+-
-.RB [\-]d \&. ddd e \\*(Pmdd
-の形に変換する。
-小数点の前には一桁の数字があり、小数点以下の桁数は精度で指定された
-桁数になる。精度は指定されなかった場合 6 とみなされる。
-精度が 0 の場合には、小数点以下は表示されない。
-.\"O .B E
-.\"O conversion uses the letter
-.\"O .B E
-.\"O (rather than
-.\"O .BR e )
-.\"O to introduce the exponent.
-.B E
-変換では、指数を表現するときに
-.RB ( e
-ではなく)
-.B E
-が使われる。
-.\"O The exponent always contains at least two
-.\"O digits; if the value is zero, the exponent is 00.
-指数部分は少なくとも 2桁表示される。
-つまり、指数の値が 0 の場合には、00 と表示される。
-.TP
-.BR f ", " F
-.\"O The
-.\"O .I double
-.\"O argument is rounded and converted to decimal notation in the style
-.\"O .RB [\-]ddd \&. ddd,
-.\"O where the number of digits after the decimal-point character is equal to
-.\"O the precision specification.
-.I double
-引き数を丸めて
-.RB [\-]ddd \&. ddd
-の形の10進表現に変換する。
-小数点の後の桁数は、精度で指定された値となる。
-.\"O If the precision is missing, it is taken as
-.\"O 6; if the precision is explicitly zero, no decimal-point character appears.
-精度が指定されていない場合には 6 として扱われる。
-精度として明示的に 0 が指定されたときには、小数点以下は表示されない。
-.\"O If a decimal point appears, at least one digit appears before it.
+適用される変換の型を指定する文字。 変換指定子とその意味は以下の通りである。
+.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 が指定されたときには、小数点以下は表示されない。
小数点を表示する際には、小数点の前に少なくとも一桁は数字が表示される。
-.\"O (The SUSv2 does not know about
-.\"O .B F
-.\"O and says that character string representations for infinity and NaN
-.\"O may be made available.
-.\"O The C99 standard specifies "[\-]inf" or "[\-]infinity"
-.\"O for infinity, and a string starting with "nan" for NaN, in the case of
-.\"O .B f
-.\"O conversion, and "[\-]INF" or "[\-]INFINITY" or "NAN*" in the case of
-.\"O .B F
-.\"O conversion.)
-(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
-.\"O The
-.\"O .I double
-.\"O argument is converted in style
-.\"O .B f
-.\"O or
-.\"O .B e
-.\"O (or
-.\"O .B F
-.\"O or
-.\"O .B E
-.\"O for
-.\"O .B G
-.\"O conversions).
-.I double
-引き数を
-.B f
-か
-.B e
-.RB ( G
-変換の場合は
-.B F
-か
-.BR E )
-の形式に変換する。
-.\"O The precision specifies the number of significant digits.
-精度は表示する桁数を指定する。
-.\"O If the precision is missing, 6 digits are given; if the precision is zero,
-.\"O it is treated as 1.
-精度が指定されない場合は、6桁とみなされる。
-精度が 0 の場合は、1桁とみなされる。
-.\"O Style
-.\"O .B e
-.\"O is used if the exponent from its conversion is less than \-4 or greater
-.\"O than or equal to the precision.
-変換される値の指数が、 \-4 より小さいか、精度以上の場合に、
-.B e
-形式が使用される。
-.\"O Trailing zeros are removed from the
-.\"O fractional part of the result; a decimal point appears only if it is
-.\"O followed by at least one digit.
-変換された結果の小数部分の末尾の 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
-.\"O (C99; not in SUSv2) For
-.\"O .B a
-.\"O conversion, the
-.\"O .I double
-.\"O argument is converted to hexadecimal notation (using the letters abcdef)
-.\"O in the style
-.\"O .RB [\-] 0x h \&. hhhh p \\*(Pmd;
-.\"O for
-.\"O .B A
-.\"O conversion the prefix
-.\"O .BR 0X ,
-.\"O the letters ABCDEF, and the exponent separator
-.\"O .B P
-.\"O is used.
-(C99 にはあるが SUSv2 にはない)
-.B a
-変換では、
-.I double
-引き数を (abcdef の文字を使って)
-.RB [\-] 0x h \&. hhhh p \\*(Pmd;
-形式の 16 進表記に変換する。
-.B A
-変換では、前置文字列
-.BR 0X ,
-文字 ABCDEF, 指数文字
-.B P
-を用いる。
-.\"O There is one hexadecimal digit before the decimal point,
-.\"O and the number of digits after it is equal to the precision.
-小数点の前には 1桁の16進数が置かれ、小数点の後ろの桁数は
-精度で指定された値となる。
-.\"O The default precision suffices for an exact representation of the value
-.\"O if an exact representation in base 2 exists
-.\"O and otherwise is sufficiently large to distinguish values of type
-.\"O .IR double .
-デフォルトの精度は、その値が 2進数で正確に表現できる場合には、
-その値を正確に表現できる桁数となる。それ以外の場合は、
-.I double
-型の値を区別するのに十分な大きさとなる。
-.\"O The digit before the decimal point is unspecified for nonnormalized
-.\"O numbers, and nonzero but otherwise unspecified for normalized numbers.
-.\" motoki 2005/03/19: 合っているかな？
-小数点の前の数字は、正規化されていない数の場合はいくつになるか分からない。
-正規化された数の場合は、 0 以外の値になるが、いくつになるかは分からない。
-.TP
-.B c
-.\"O If no
-.\"O .B l
-.\"O modifier is present, the
-.\"O .I int
-.\"O argument is converted to an
-.\"O .IR "unsigned char" ,
-.\"O and the resulting character is written.
-.B l
-修飾子がなければ、
-.I int
-引き数を
-.IR "unsigned char"
-に変換して、その結果に対応する文字を出力する。
-.\"O If an
-.\"O .B l
-.\"O modifier is present, the
-.\"O .I wint_t
-.\"O (wide character) argument is converted to a multibyte sequence by a call
-.\"O to the
-.\"O .BR wcrtomb (3)
-.\"O function, with a conversion state starting in the initial state, and the
-.\"O resulting multibyte string is written.
-.B l
-修飾子があれば、
-.I wint_t
-(ワイド文字) 引き数を、
-.BR wcrtomb (3)
-関数を初期シフト状態で呼び出してマルチバイト文字列に変換し、
-変換されたマルチバイト文字列を出力する。
-.TP
-.B s
-.\"O If no
-.\"O .B l
-.\"O modifier is present: The
-.\"O .I "const char *"
-.\"O argument is expected to be a pointer to an array of character type (pointer
-.\"O to a string).
-.\"O Characters from the array are written up to (but not
-.\"O including) a terminating null byte (\(aq\\0\(aq);
-.\"O if a precision is specified, no more than the number specified
-.\"O are written.
-.\"O If a precision is given, no null byte need be present;
-.\"O if the precision is not specified, or is greater than the size of the
-.\"O array, the array must contain a terminating null byte.
-.B l
-修飾子がない場合、
-引き数は
-.I "const char *"
-型で文字型の配列へのポインタ (文字列へのポインタ) であることが
-期待されている。配列中の文字は、終端の NULL バイト (\(aq\\0\(aq)
-が出てくるまで出力される (終端文字は出力されない)。
-精度が指定されていると、指定された字数以上は出力されない。
-精度が指定された場合には、終端バイトが存在する必要はない。
-精度が指定されていなかったり、精度の値が配列の大きさより大きい場合には、
-配列は終端の NULL バイトを含んでいなければならない。
-
-.\"O If an
-.\"O .B l
-.\"O modifier is present: The
-.\"O .I "const wchar_t *"
-.\"O argument is expected to be a pointer to an array of wide characters.
-.B l
-修飾子が指定されている場合、
-引き数は
-.I "const wchar_t *"
-型でワイド文字の配列へのポインタであることが期待されている。
-.\"O Wide characters from the array are converted to multibyte characters
-.\"O (each by a call to the
-.\"O .BR wcrtomb (3)
-.\"O function, with a conversion state starting in the initial state before
-.\"O the first wide character), up to and including a terminating null
-.\"O wide character.
-.\"O The resulting multibyte characters are written up to
-.\"O (but not including) the terminating null byte.
-.\"O If a precision is
-.\"O specified, no more bytes than the number specified are written, but
-.\"O no partial multibyte characters are written.
-.\"O Note that the precision
-.\"O determines the number of
-.\"O .I bytes
-.\"O written, not the number of
-.\"O .I wide characters
-.\"O or
-.\"O .IR "screen positions" .
-配列中のワイド文字は (1文字毎に
-.BR wcrtomb (3)
-を呼び出して) マルチバイト文字に変換される
-(最初のワイド文字の変換の前に
-.BR wcrtomb ()
-のシフト状態を初期状態に戻してから変換は行われる)。
-マルチバイト文字への変換は、文字列を終端する NULL ワイド文字が
-出てくるまで行われ、終端 NULL ワイド文字も含めて変換される。
-結果のマルチバイト文字列は、終端の NULL バイトが出てくるまで
-出力される (終端の NULL バイトは出力されない)。
-精度が指定された場合、指定されたバイト数以上には出力されない。
-但し、マルチバイト文字の一部分だけが出力されることはない。
-精度は「バイト」数を指定するものであり、「ワイド文字」数や
-「画面での位置」を指定するものではないことに注意。
-.\"O The array must contain a terminating null wide character, unless a
-.\"O precision is given and it is so small that the number of bytes written
-.\"O exceeds it before the end of the array is reached.
-精度が指定されていて、さらに出力が配列の末尾に達する前に出力バイト数が
-精度の値を超える場合だけは、配列は NULL ワイド文字で終端されていなくてもよい。
-それ以外の場合は、必ず配列は NULL ワイド文字で終端されていなければならない。
-.TP
-.B C
-.\"O (Not in C99, but in SUSv2.)
-.\"O Synonym for
-.\"O .BR lc .
-.\"O Don't use.
-(C99 にはないが SUSv2 にはある)
-.B lc
-と同じ。使ってはならない。
-.TP
-.B S
-.\"O (Not in C99, but in SUSv2.)
-.\"O Synonym for
-.\"O .BR ls .
-.\"O Don't use.
-(C99 にはないが SUSv2 にはある)
-.B ls
-と同じ。使ってはならない。
-.TP
-.B p
-.\"O The
-.\"O .I "void *"
-.\"O pointer argument is printed in hexadecimal (as if by
-.\"O .B %#x
-.\"O or
-.\"O .BR %#lx ).
-.I "void *"
-ポインタ引き数を
-.RB ( %#x
-や
-.BR %#lx
-のような) 16 進数で出力する。
-.TP
-.B n
-.\"O The number of characters written so far is stored into the integer
-.\"O indicated by the
-.\"O .I "int *"
-.\"O (or variant) pointer argument.
-.\"O No argument is converted.
-これまでに出力された文字数を
-.I "int *"
-(または類似の型) のポインタ引き数が指す整数に保存する。
-引き数の変換は行われない。
-.TP
-.B m
-.\"O (Glibc extension.)
-.\"O Print output of
-.\"O .IR strerror(errno) .
-.\"O No argument is required.
-(glibc での拡張)
-.I strerror(errno)
-の出力を表示する。引き数は必要ない。
-.TP
-.B %
-.\"O A \(aq%\(aq is written.
-.\"O No argument is converted.
-.\"O The complete conversion
-.\"O specification is \(aq%%\(aq.
-\(aq%\(aq 文字を出力する。変換される引き数は無い。
-変換指定全体を書くと "%%" となる。
-.\"O .SH "CONFORMING TO"
+.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 準拠
-.\"O The
-.\"O .BR fprintf (),
-.\"O .BR printf (),
-.\"O .BR sprintf (),
-.\"O .BR vprintf (),
-.\"O .BR vfprintf (),
-.\"O and
-.\"O .BR vsprintf ()
-.\"O functions conform to C89 and C99.
-.BR fprintf (),
-.BR printf (),
-.BR sprintf (),
-.BR vprintf (),
-.BR vfprintf (),
-.BR vsprintf ()
-関数は、C89 と C99 に準拠している。
-.\"O The
-.\"O .BR snprintf ()
-.\"O and
-.\"O .BR vsnprintf ()
-.\"O functions conform to 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
-.\"O Concerning the return value of
-.\"O .BR snprintf (),
-.\"O SUSv2 and C99 standard contradict each other: when
-.\"O .BR snprintf ()
-.\"O is called with
-.\"O .IR size =0
-.\"O then SUSv2 stipulates an unspecified return value less than 1,
-.\"O while C99 allows
-.\"O .I str
-.\"O to be NULL in this case, and gives the return value (as always)
-.\"O as the number of characters that would have been written in case
-.\"O the output string has been large enough.
-.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
-.\"O Linux libc4 knows about the five C standard flags.
-.\"O It knows about the length modifiers \fBh\fP, \fBl\fP, \fBL\fP,
-.\"O and the conversions
-.\"O \fBc\fP, \fBd\fP, \fBe\fP, \fBE\fP, \fBf\fP, \fBF\fP,
-.\"O \fBg\fP, \fBG\fP, \fBi\fP, \fBn\fP, \fBo\fP, \fBp\fP,
-.\"O \fBs\fP, \fBu\fP, \fBx\fP, and \fBX\fP,
-.\"O where \fBF\fP is a synonym for \fBf\fP.
-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 と同義である。
-.\"O Additionally, it accepts \fBD\fP, \fBO\fP, and \fBU\fP as synonyms
-.\"O for \fBld\fP, \fBlo\fP, and \fBlu\fP.
-.\"O (This is bad, and caused serious bugs later, when
-.\"O support for \fB%D\fP disappeared.)
-.\"O No locale-dependent radix character,
-.\"O no thousands' separator, no NaN or infinity, no "%m$" and "*m$".
-また、 \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
-.\"O Linux libc5 knows about the five C standard flags and the \(aq flag,
-.\"O locale, "%m$" and "*m$".
-.\"O It knows about the length modifiers \fBh\fP, \fBl\fP, \fBL\fP,
-.\"O \fBZ\fP, and \fBq\fP, but accepts \fBL\fP and \fBq\fP
-.\"O both for \fIlong double\fP and for \fIlong long int\fP (this is a bug).
-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 に対応している (これはバグである)。
-.\"O It no longer recognizes \fBF\fP, \fBD\fP, \fBO\fP, and \fBU\fP,
-.\"O but adds the conversion character
-.\"O .BR m ,
-.\"O which outputs
-.\"O .IR strerror(errno) .
-現在では変換 \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
-.\"O glibc 2.0 adds conversion characters \fBC\fP and \fBS\fP.
glibc 2.0 では、変換文字 \fBC\fP と \fBS\fP が追加された。
.PP
-.\"O glibc 2.1 adds length modifiers \fBhh\fP, \fBj\fP, \fBt\fP, and \fBz\fP
-.\"O and conversion characters \fBa\fP and \fBA\fP.
-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
-.\"O glibc 2.2 adds the conversion character \fBF\fP with C99 semantics,
-.\"O and the flag character \fBI\fP.
-glibc 2.2 では、 C99 で規定された意味での変換文字 \fBF\fP と
-フラグ文字 \fBI\fP が追加された。
-.\"O .SH NOTES
+glibc 2.2 では、 C99 で規定された意味での変換文字 \fBF\fP と フラグ文字 \fBI\fP が追加された。
.SH 注意
-.\"O Some programs imprudently rely on code such as the following
-.\"O
-.\"O sprintf(buf, "%s some further text", buf);
-.\"O
-.\"O to append text to
-.\"O .IR buf .
-テキストを
-.I buf
-に追加するのに、軽率にも次のようなコードを使っているプログラムがある。
+テキストを \fIbuf\fP に追加するのに、軽率にも次のようなコードを使っているプログラムがある。
sprintf(buf, "%s some further text", buf);
-.\"O However, the standards explicitly note that the results are undefined
-.\"O if source and destination buffers overlap when calling
-.\"O .BR sprintf (),
-.\"O .BR snprintf (),
-.\"O .BR vsprintf (),
-.\"O and
-.\"O .BR vsnprintf ().
-しかしながら、標準規格では、
-.BR sprintf (),
-.BR snprintf (),
-.BR vsprintf (),
-.BR vsnprintf ()
-の呼び出しにおいて、コピー元とコピー先のバッファが重なっていた場合の
-結果は不定である、と明記されている。
.\" http://sourceware.org/bugzilla/show_bug.cgi?id=7075
-.\"O Depending on the version of
-.\"O .BR gcc (1)
-.\"O used, and the compiler options employed, calls such as the above will
-.\"O .B not
-.\"O produce the expected results.
-使用する
-.BR gcc (1)
-のバージョンや指定したコンパイラのオプション次第では、
-上記のような呼び出しで、期待した結果が得られ「ない」ことがある。
+しかしながら、標準規格では、 \fBsprintf\fP(), \fBsnprintf\fP(), \fBvsprintf\fP(), \fBvsnprintf\fP()
+の呼び出しにおいて、コピー元とコピー先のバッファが重なっていた場合の 結果は不定である、と明記されている。 使用する \fBgcc\fP(1)
+のバージョンや指定したコンパイラのオプション次第では、 上記のような呼び出しで、期待した結果が得られ「ない」ことがある。
-.\"O The glibc implementation of the functions
-.\"O .BR snprintf ()
-.\"O and
-.\"O .BR vsnprintf ()
-.\"O conforms to the C99 standard, that is, behaves as described above,
-.\"O since glibc version 2.1.
-.\"O Until glibc 2.0.6 they would return \-1
-.\"O when the output was truncated.
-glibc の
-.BR snprintf ()
-と
-.BR vsnprintf ()
-の実装は、バージョン 2.1 以降は C99 標準に準拠しており、
-上記の通りの動作をする。
-glibc 2.0.6 までは、出力が切り詰められた場合は \-1 を返す。
-.\"O .\" .SH HISTORY
-.\" .SH 歴史
-.\"O .\" UNIX V7 defines the three routines
-.\"O .\" .BR printf (),
-.\"O .\" .BR fprintf (),
-.\"O .\" .BR sprintf (),
-.\"O .\" and has the flag \-, the width or precision *, the length modifier l,
-.\"O .\" and the conversions doxfegcsu, and also D,O,U,X as synonyms for ld,lo,lu,lx.
-.\" 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 が定義されている。
-.\"O .\" This is still true for 2.9.1BSD, but 2.10BSD has the flags
-.\"O .\" #, + and <space> and no longer mentions D,O,U,X.
-.\" 2.9.1BSD でもこれは同じだったが、 2.10BSD では
-.\" フラグ #, +, 空白が追加され、 D,O,U,X については記載されなくなった。
-.\"O .\" 2.11BSD has
-.\"O .\" .BR vprintf (),
-.\"O .\" .BR vfprintf (),
-.\"O .\" .BR vsprintf (),
-.\"O .\" and warns not to use 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 を使わないように警告された。
-.\"O .\" 4.3BSD Reno has the flag 0, the length modifiers h and L,
-.\"O .\" and the conversions n, p, E, G, X (with current meaning)
-.\"O .\" and deprecates D,O,U.
-.\" 4.3BSD Reno ではフラグ 0、長さ修飾子 h と L、
-.\" 変換 n, p, E, G, (現在の意味での) X が追加され、
-.\" D,O,U は非推奨扱いとなった。
-.\"O .\" 4.4BSD introduces the functions
-.\"O .\" .BR snprintf ()
-.\"O .\" and
-.\"O .\" .BR vsnprintf (),
-.\"O .\" and the length modifier q.
-.\" 4.4BSD では、関数
-.\" .BR snprintf ()と
-.\" .BR vsnprintf ()、
-.\" 長さ修飾子 q が導入された。
-.\"O .\" FreeBSD also has functions
-.\"O .\" .BR asprintf ()
-.\"O .\" and
-.\"O .\" .BR vasprintf (),
-.\"O .\" that allocate a buffer large enough for
-.\"O .\" .BR sprintf ().
-.\" 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 ()
-.\" が追加されている。
-.\"O .\" In glibc there are functions
-.\"O .\" .BR dprintf ()
-.\"O .\" and
-.\"O .\" .BR vdprintf ()
-.\"O .\" that print to a file descriptor instead of a stream.
-.\" 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 ()
-.\" があり、これらはストリームではなくファイルディスクリプタに出力する。
-.\"O .SH BUGS
+.\" that print to a file descriptor instead of a stream.
+glibc の \fBsnprintf\fP() と \fBvsnprintf\fP() の実装は、バージョン 2.1 以降は C99 標準に準拠しており、
+上記の通りの動作をする。 glibc 2.0.6 までは、出力が切り詰められた場合は \-1 を返す。
.SH バグ
-.\"O Because
-.\"O .BR sprintf ()
-.\"O and
-.\"O .BR vsprintf ()
-.\"O assume an arbitrarily long string, callers must be careful not to overflow
-.\"O the actual space; this is often impossible to assure.
-.\"O Note that the length
-.\"O of the strings produced is locale-dependent and difficult to predict.
-.BR sprintf ()
-と
-.BR vsprintf ()
-は勝手に十分に長い文字列領域があると仮定するので、呼び出し側は
-実際の領域からあふれないように注意しなければならない。
-しかし、これを保証することが不可能な場合が多い。
-生成される文字列の長さはロケール依存であり、予測が難しいことに注意。
-.\"O Use
-.\"O .BR snprintf ()
-.\"O and
-.\"O .BR vsnprintf ()
-.\"O instead (or
-.\"O .BR asprintf (3)
-.\"O and
-.\"O .BR vasprintf (3)).
-代わりに
-.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
-.\"O Linux libc4.[45] does not have a
-.\"O .BR snprintf (),
-.\"O but provides a libbsd that contains an
-.\"O .BR snprintf ()
-.\"O equivalent to
-.\"O .BR sprintf (),
-.\"O that is, one that ignores the
-.\"O .I size
-.\"O argument.
-Linux libc4.[45] には
-.BR snprintf ()
-はないが、 libbsd が提供されており、
-その中には
-.BR sprintf ()
-と等価な (つまり
-.I size
-引き数を無視する)
-.BR snprintf ()
-がある。
-.\"O Thus, the use of
-.\"O .BR snprintf ()
-.\"O with early libc4 leads to serious security problems.
-したがって、初期の libc4 で
-.BR snprintf ()
-を使うと、深刻なセキュリティ問題を引き起こすことがある。
+Linux libc4.[45] には \fBsnprintf\fP() はないが、 libbsd が提供されており、 その中には \fBsprintf\fP()
+と等価な (つまり \fIsize\fP 引き数を無視する) \fBsnprintf\fP() がある。 したがって、初期の libc4 で
+\fBsnprintf\fP() を使うと、深刻なセキュリティ問題を引き起こすことがある。
.PP
-.\"O Code such as
-.\"O .BI printf( foo );
-.\"O often indicates a bug, since
-.\"O .I foo
-.\"O may contain a % character.
-.\"O If
-.\"O .I foo
-.\"O comes from untrusted user input, it may contain \fB%n\fP, causing the
-.\"O .BR printf ()
-.\"O call to write to memory and creating a security hole.
-.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 での実数変換にはメモリリークを引き起こすことがある。
-.\"O .SH EXAMPLE
+.\" .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
-.\"O To print \*(Pi to five decimal places:
+.if \w'\*(Pi'=0 .ds Pi pi
\*(Pi を 5 桁で出力する。
.in +4n
.nf
.fi
.in
.PP
-.\"O To print a date and time in the form "Sunday, July 3, 10:02",
-.\"O where
-.\"O .I weekday
-.\"O and
-.\"O .I month
-.\"O are pointers to strings:
-日付と時間を "Sunday, July 3, 10:02" の形式で出力する。
-.RI ( weekday
-と
-.I month
+日付と時間を "Sunday, July 3, 10:02" の形式で出力する。 (\fIweekday\fP と \fImonth\fP
は文字列へのポインタである)
.in +4n
.nf
.fi
.in
.PP
-.\"O Many countries use the day-month-year order.
-.\"O Hence, an internationalized version must be able to print
-.\"O the arguments in an order specified by the format:
-日 - 月 - 年 の順序で表示を行う国も多い。
-従って、国際版では書式で指定された順番で
-引き数を表示できなければならない。
+日 \- 月 \- 年 の順序で表示を行う国も多い。 従って、国際版では書式で指定された順番で 引き数を表示できなければならない。
.in +4n
.nf
.fi
.in
-.\"O where
-.\"O .I format
-.\"O depends on locale, and may permute the arguments.
-.\"O With the value:
-.I format
-はロケールに依存しており、引き数の順番を変えることもできる。
-.I format
-が
+\fIformat\fP はロケールに依存しており、引き数の順番を変えることもできる。 \fIformat\fP が
.in +4n
.nf
.fi
.in
-.\"O one might obtain "Sonntag, 3. Juli, 10:02".
であれば、 "Sonntag, 3. Juli, 10:02" という結果になる。
.PP
-.\"O To allocate a sufficiently large string and print into it
-.\"O (code correct for both glibc 2.0 and glibc 2.1):
-十分に大きな文字列領域を確保して、そこにメッセージを格納するには
-(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
-.\"O .SH "SEE ALSO"
.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
