printf

関数の概要

PHPの printf 関数は、書式指定子を使って整形した文字列を画面に直接出力するための関数です。数値や文字列を特定の形式で表示したい場合に便利で、特に桁数や小数点以下の桁数を指定したいときによく使われます。
標準出力に文字列を表示したい場合に用いる基本的な関数です。

パラメータの説明

  • format:表示したい書式を表す文字列。%を使った書式指定子(例:%d%s)を含めます。
  • args...formatの書式指定子に対応する値。数値や文字列など、複数指定できます。

戻り値

printfは、画面に出力した文字列のバイト数(文字数)を返します。失敗した場合は false を返します。

使用例

基本的な使い方

<?php
printf("こんにちは、%sさん!", "太郎");
?>

この例では「こんにちは、太郎さん!」と表示されます。%s は文字列を表示する書式指定子です。

数値の桁数を揃えて表示

<?php
printf("売上金額: %08d 円", 12345);
?>

この場合、数値を8桁になるよう先頭に0を埋めて「売上金額: 00012345 円」と表示します。%08d は「8文字分、足りない部分は0で埋める」という意味です。

小数点以下の桁数指定

<?php
printf("円周率の近似値: %.3f", 3.14159265);
?>

%.3f は小数点以下3桁まで表示する書式指定子です。結果は「円周率の近似値: 3.142」となります(四捨五入されます)。

関連する関数

  • sprintf:書式付き文字列を返り値として得る(出力はしない)
  • vprintf:配列で渡した引数で書式付き文字列を出力
  • print:単純に文字列を出力する

まとめ

printf はPHPで書式付きの文字列を画面へ出力する際に使う基本的な関数です。数値の桁数や小数点以下の精度を簡単に整形できるため、表示を見やすくしたい場合に便利です。
実務でもレポートやログ、ユーザーへのメッセージ表示などで活用されます。
使い方を覚えておくと、文字列処理の幅が広がるでしょう。