【PHP8.x】printf関数の使い方

Copy
1<?php
2
3/**
4 * printf 関数の使用例
5 *
6 * 指定されたフォーマットに従って文字列を出力します。
7 */
8
9// 文字列と数値をフォーマットして出力
10$name = "Taro";
11$age = 30;
12$formattedString = sprintf("My name is %s, and I am %d years old.", $name, $age);
13echo $formattedString . PHP_EOL; // My name is Taro, and I am 30 years old.
14
15// 浮動小数点数をフォーマットして出力
16$price = 19.99;
17printf("The price is %.2f dollars.\n", $price); // The price is 19.99 dollars.
18
19// 複数の値をフォーマットして出力
20$quantity = 5;
21$item = "apple";
22printf("I have %d %ss.\n", $quantity, $item); // I have 5 apples.
23
24// 16進数で出力
25$number = 255;
26printf("The hexadecimal value is %X.\n", $number); // The hexadecimal value is FF.
27
28// パーセント記号を出力
29$percentage = 85;
30printf("The success rate is %d%%.\n", $percentage); // The success rate is 85%.
31?>

printf関数は、PHPで指定されたフォーマットに基づいて文字列を出力するために使用されます。第一引数$formatは、出力形式を指定する文字列です。この文字列には、プレースホルダーと呼ばれる特殊な記号が含まれており、...$valuesで指定された値が対応するプレースホルダーの位置に埋め込まれます。

例えば、%sは文字列、%dは整数、%fは浮動小数点数をそれぞれ表します。%.2fのように小数点以下の桁数を指定することも可能です。%Xは数値を16進数で出力します。パーセント記号を出力したい場合は、%%と記述します。

サンプルコードでは、sprintf関数と組み合わせて、フォーマットされた文字列を変数に格納してからechoで出力する方法も示されています。sprintf関数はprintf関数と似ていますが、出力を直接行うのではなく、フォーマットされた文字列を返します。printf関数は出力された文字列の長さを整数値で返します。PHP_EOLは、改行文字を表す定義済みの定数で、プラットフォームに依存しない改行を行う際に便利です。printf関数を使うことで、変数の値を埋め込んだり、数値の表示形式を整えたりして、見やすく、より分かりやすい出力を実現できます。

Copy
1<?php
2
3/**
4 * printf 関数を使った改行付きの出力例
5 */
6function printfWithNewline(): void
7{
8    $name = "太郎";
9    $age = 30;
10
11    // 名前と年齢を改行付きで出力
12    $result = printf("名前: %s\n年齢: %d\n", $name, $age);
13
14    // printf は出力した文字数を返す
15    echo "出力文字数: " . $result . "\n";
16}
17
18// 関数の実行
19printfWithNewline();
20
21?>

PHPのprintf関数は、指定されたフォーマット文字列に従って引数を整形し、結果を出力する関数です。この関数を使うことで、変数の値を埋め込んだ文字列を簡単に生成し、画面やファイルに出力できます。

printf関数の第一引数には、フォーマット文字列を指定します。フォーマット文字列には、プレースホルダーと呼ばれる特殊な記号が含まれており、%s（文字列）、%d（整数）などの種類があります。これらのプレースホルダーは、続く引数の値で順番に置き換えられます。例えば、printf("名前: %s 年齢: %d", $name, $age)というコードは、$nameと$ageの値をフォーマット文字列に埋め込んで出力します。

サンプルコードでは、printfWithNewline関数内でprintf関数を使って、名前と年齢を改行付きで出力しています。\nは改行文字を表し、出力結果を読みやすくするために使用されています。

printf関数の戻り値は、出力した文字数です。サンプルコードでは、$result = printf("名前: %s\n年齢: %d\n", $name, $age)のように、戻り値を変数に格納し、その後echo "出力文字数: " . $result . "\n";で出力しています。これによって、printf関数が実際に何文字出力したかを確認できます。printf関数は、複雑な文字列のフォーマットや、数値の書式設定など、多様な出力形式に対応できる便利な関数です。