フォーマット文字列
format
に基づき生成された 文字列を返します。
フォーマット文字列は0個以上のディレクティブ(指示子)により
構成されます。ディレクティブには、そのまま結果にコピーされる (
%
を除く)通常の文字と
変換指定子 (conversion specifications)
があり、取り出される際は どちらもそれ自身がパラメータとなります。このことは
sprintf()
の場合だけでなく
printf()
の場合も同様です。
各変換指定子はパーセント記号(
%
)の後に、これら の要素が一つ以上続いたものになります。
オプションの
パディング指定子
。これは、 文字列が正しい長さになるまでどんな文字で埋めるかということを 指定します。これは空白かまたは
0
(文字'0') のいずれかです。デフォルトでは空白で埋められます。
これ以外のパディング文字を指定するには、その文字の前に単一 引用符(
'
)を置きます。後述の例を参照して ください。
オプションの
アラインメント指定子
。これは 結果を左寄せまたは右寄せにしたい場合に指定します。デフォルトは 右寄せです。ここで
-
文字を指定すると左寄せ となります。
オプションの数字。これは
表示幅指定子
です。 結果を(最低)何桁にするかを指定します。
オプションの
精度指定子
。これは、浮動小数点 数に対して何個の数字を表示するか??定します。このオプションは、
double(倍精度)型以外には何の効果もありません。 (数字をフォーマットする際に便利な関数として他に
number_format()
があります。)
型指定子
。引数を何の型として扱うかを指定 します。指定できる型を以下に示します。
% - パーセント文字。引数は不要です。 |
b - 引数を整数として扱い、バイナリの数値 として表現します。 |
c - 引数を整数として扱い、その ASCII 値 の文字として表現します。 |
d - 引数を整数として扱い、10 進数として 表現します。 |
u - 引数を整数として扱い、符号無しの10進 数として表現します。 |
f - 引数を double として扱い、浮動小数点数 として表現します。 |
o - 引数を整数として扱い、8 進数として 表現します。 |
s - 引数を文字列として扱い、表現します。 |
x - 引数を整数として扱い、16 進数として (小文字で)表現します。 |
X - 引数を整数として扱い、16 進数として (大文字で)表現します。 |
PHP バージョン 4.0.6 でフォーマット文字列で引数の番号付け/交換が
サポートされました。以下に例を示します。
printf()
,
sscanf()
,
fscanf()
,
number_format()
も参照下さい。