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