【PHP8.x】PHP_ROUND_HALF_UP定数の使い方

Copy
1<?php
2
3/**
4 * PHP_ROUND_HALF_UP と PHP_ROUND_HALF_DOWN 定数を使用した数値の丸め処理の例。
5 * これらの定数は round() 関数の第3引数 ($mode) として、中間値 (X.5) の丸め挙動を制御します。
6 */
7function demonstrateRoundingModes(): void
8{
9    // 丸める対象の浮動小数点数（整数部で丸める場合）
10    $positiveHalf = 3.5;
11    $negativeHalf = -3.5;
12
13    echo "--- 整数に丸める処理 ---" . PHP_EOL;
14
15    // PHP_ROUND_HALF_UP: 中間値 (X.5) を、0から遠ざかる方向に丸めます。
16    // 例: 3.5 は 4, -3.5 は -3
17    echo "PHP_ROUND_HALF_UP ({$positiveHalf}): " . round($positiveHalf, 0, PHP_ROUND_HALF_UP) . PHP_EOL;
18    echo "PHP_ROUND_HALF_UP ({$negativeHalf}): " . round($negativeHalf, 0, PHP_ROUND_HALF_UP) . PHP_EOL;
19
20    // PHP_ROUND_HALF_DOWN: 中間値 (X.5) を、0に近づく方向に丸めます。
21    // 例: 3.5 は 3, -3.5 は -4
22    echo "PHP_ROUND_HALF_DOWN ({$positiveHalf}): " . round($positiveHalf, 0, PHP_ROUND_HALF_DOWN) . PHP_EOL;
23    echo "PHP_ROUND_HALF_DOWN ({$negativeHalf}): " . round($negativeHalf, 0, PHP_ROUND_HALF_DOWN) . PHP_EOL;
24
25    echo PHP_EOL . "--- 小数点以下を丸める処理 ---" . PHP_EOL;
26
27    // 小数点以下第2位で丸める場合 (値が X.X5 のケースで違いが明確)
28    $valueForPrecision = 3.145;
29
30    // PHP_ROUND_HALF_UP: 指定された桁で中間値 (X.X5) を切り上げます。
31    // 例: 3.145 を小数点以下第2位で丸めると 3.15
32    echo "PHP_ROUND_HALF_UP ({$valueForPrecision}, 2): " . round($valueForPrecision, 2, PHP_ROUND_HALF_UP) . PHP_EOL;
33
34    // PHP_ROUND_HALF_DOWN: 指定された桁で中間値 (X.X5) を切り下げます。
35    // 例: 3.145 を小数点以下第2位で丸めると 3.14
36    echo "PHP_ROUND_HALF_DOWN ({$valueForPrecision}, 2): " . round($valueForPrecision, 2, PHP_ROUND_HALF_DOWN) . PHP_EOL;
37}
38
39// 関数を実行して結果を表示
40demonstrateRoundingModes();

このPHPコードは、数値の丸め処理を行うround()関数と、その挙動を制御する定数PHP_ROUND_HALF_UPおよびPHP_ROUND_HALF_DOWNの使用方法を示しています。これらの定数はround()関数の第3引数として指定し、小数点以下がちょうど中間値（例えばX.5やX.X5）の場合に、どのように丸めるかを決定する整数値（int）です。

PHP_ROUND_HALF_UPは、中間値を「0から遠ざかる方向」に丸めます。具体的には、3.5は4に、-3.5は-3に丸められます。小数点以下を指定した桁で丸める場合も同様で、例えば3.145を小数点以下第2位で丸めると3.15となります。この定数自体には引数はありません。

一方、PHP_ROUND_HALF_DOWNは、中間値を「0に近づく方向」に丸めます。これにより、3.5は3に、-3.5は-4に丸められます。小数点以下第2位で3.145を丸める場合は3.14となります。こちらも引数はなく、常に整数値を返します。

これらの定数を使い分けることで、アプリケーションの要件に応じて、厳密な数値の丸め処理を正確に制御することが可能になります。

Copy
1<?php
2
3/**
4 * PHPのround()関数における異なる丸めモードの動作を示します。
5 * システムエンジニア初心者向けに、特にPHP_ROUND_HALF_UPとPHP_ROUND_HALF_DOWNの違いを強調します。
6 */
7function demonstrateRoundingModes(): void
8{
9    echo "--- round() 関数の丸めモードのデモンストレーション ---\n\n";
10
11    // 丸め処理を行う数値のリスト
12    $numbersToRound = [
13        2.5,   // 正の数、端数が.5
14        2.4,   // 正の数、端数が.5未満
15        2.6,   // 正の数、端数が.5より大きい
16        -2.5,  // 負の数、端数が.5
17        -2.4,  // 負の数、端数が.5未満
18        -2.6,  // 負の数、端数が.5より大きい
19    ];
20
21    foreach ($numbersToRound as $number) {
22        echo "元の数値: " . $number . "\n";
23
24        // PHP 8のデフォルト丸めモードはPHP_ROUND_HALF_UPと同じ挙動です。
25        // 明示的な指定がない場合、最も一般的な四捨五入（0.5は切り上げ）が行われます。
26        $defaultRounded = round($number);
27        echo "  - デフォルト (PHP_ROUND_HALF_UPと同じ): " . $defaultRounded . "\n";
28
29        // PHP_ROUND_HALF_UP:
30        // 小数部分が0.5の場合に切り上げ（正の無限大方向へ）。
31        // 例: 2.5 は 3、-2.5 は -2 になります。
32        $halfUpRounded = round($number, 0, PHP_ROUND_HALF_UP);
33        echo "  - PHP_ROUND_HALF_UP         : " . $halfUpRounded . " (0.5は切り上げ)\n";
34
35        // PHP_ROUND_HALF_DOWN:
36        // 小数部分が0.5の場合に切り捨て（0方向へ）。
37        // 例: 2.5 は 2、-2.5 は -3 になります。
38        $halfDownRounded = round($number, 0, PHP_ROUND_HALF_DOWN);
39        echo "  - PHP_ROUND_HALF_DOWN       : " . $halfDownRounded . " (0.5は切り捨て)\n";
40        echo "\n";
41    }
42
43    echo "--- デモンストレーション終了 ---\n";
44}
45
46// 関数を実行し、丸めモードの動作を確認します。
47demonstrateRoundingModes();

PHPのPHP_ROUND_HALF_UPは、数値を丸める際の特定の振る舞いを指定するための定数です。この定数自体に引数はなく、内部的に整数値（int）を返します。主にround()関数と組み合わせて使用されます。round()関数は、第一引数に丸めたい数値、第二引数に丸める小数点以下の桁数、そして第三引数にPHP_ROUND_HALF_UPのような丸めモードの定数を指定します。戻り値として、丸められた数値が返されます。

PHP_ROUND_HALF_UPが指定された場合、小数部分がちょうど0.5の時に、正の無限大方向へ切り上げられます。例えば、2.5は3に丸められ、-2.5は-2に丸められます。これはPHP 8におけるround()関数のデフォルトの挙動と同じです。

比較としてPHP_ROUND_HALF_DOWNという定数もあります。こちらは小数部分が0.5の場合に、0の方向へ切り捨てを行います。例えば2.5は2に、-2.5は-3に丸められます。サンプルコードでは、これらの違いを具体的な数値で示しており、特に2.5や-2.5のような「0.5」で終わる数値が、指定するモードによってどのように処理されるかが明確に理解できます。システムの要件に応じて、適切な丸めモードを選択することが重要です。