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

Copy
1<?php
2
3/**
4 * PHPのround()関数における異なる丸めモード、
5 * 特に PHP_ROUND_HALF_UP と PHP_ROUND_HALF_ODD の挙動を比較して示します。
6 *
7 * PHP_ROUND_HALF_UP は小数点以下が0.5の場合に常に切り上げます。
8 * PHP_ROUND_HALF_ODD は小数点以下が0.5の場合に最も近い'奇数'に丸めます。
9 */
10function demonstrateRoundingModesComparison(): void
11{
12    // 丸め処理を行う数値のリスト（0.5の端数を含むものを中心に）
13    $numbers = [2.5, 3.5, 4.5, 5.5, -2.5, -3.5];
14    $precision = 0; // 整数に丸める（小数点以下第0位）
15
16    echo "--- round() 関数の異なる丸めモードの比較 ---\n\n";
17    echo "数値 | PHP_ROUND_HALF_UP (0.5を切り上げ) | PHP_ROUND_HALF_ODD (0.5を最も近い奇数に丸める)\n";
18    echo "-----------------------------------------------------------------------------------\n";
19
20    foreach ($numbers as $number) {
21        // PHP_ROUND_HALF_UP モードで丸める
22        // 例: 2.5 -> 3, 3.5 -> 4, -2.5 -> -3
23        $roundedHalfUp = round($number, $precision, PHP_ROUND_HALF_UP);
24
25        // PHP_ROUND_HALF_ODD モードで丸める
26        // 例: 2.5 -> 3 (2と3で3が奇数), 3.5 -> 3 (3と4で3が奇数), 4.5 -> 5 (4と5で5が奇数)
27        // 例: -2.5 -> -3 (-2と-3で-3が奇数)
28        $roundedHalfOdd = round($number, $precision, PHP_ROUND_HALF_ODD);
29
30        printf(
31            "%5.1f | %-31d | %d\n",
32            $number,
33            $roundedHalfUp,
34            $roundedHalfOdd
35        );
36    }
37
38    echo "\n補足:\n";
39    echo "- PHP_ROUND_HALF_UP: 0.5の端数がある場合、常に絶対値が大きい方に丸めます。\n";
40    echo "- PHP_ROUND_HALF_ODD: 0.5の端数がある場合、最も近い'奇数'に丸めます。\n";
41    echo "  例えば、2.5 は 2 と 3 の間で 3 が奇数なので 3 に、3.5 は 3 と 4 の間で 3 が奇数なので 3 に丸められます。\n";
42}
43
44// 関数を実行して結果を表示
45demonstrateRoundingModesComparison();

PHPのround()関数は数値を指定された精度で丸めるために使用されますが、その丸め方にはいくつかのモードがあります。このサンプルコードは、特にPHP_ROUND_HALF_UPとPHP_ROUND_HALF_ODDという二つのモードが、0.5の端数を持つ数値に対してどのように動作するかを比較して示しています。

PHP_ROUND_HALF_UPモードは、小数点以下が0.5の場合に、常に絶対値が大きくなる方へ丸めます。これは一般的に「四捨五入」として知られる動作に近く、例えば2.5は3に、-2.5は-3に丸められます。

一方、PHP_ROUND_HALF_ODDモードは、小数点以下が0.5の場合に、最も近い「奇数」に丸める特殊なモードです。例えば、2.5は2と3の間で3が奇数なので3に丸められますが、3.5も3と4の間で3が奇数なので3に丸められます。負の数である-2.5では、-3と-2の間で-3が奇数なので-3に丸められます。PHP_ROUND_HALF_ODD定数自体は、round()関数の振る舞いを指定するための整数値（int）であり、引数はありません。

コードでは、2.5、3.5、-2.5などの複数の数値をリストアップし、それぞれのモードで丸めた結果を並べて表示しています。これにより、同じ数値でも丸めモードによって最終的な値が異なることが明確に理解できます。round()関数は指定された数値と精度、そして丸めモードに基づいて計算を行い、丸められた結果の数値を返します。

Copy
1<?php
2
3/**
4 * PHPの丸め定数 PHP_ROUND_HALF_ODD と PHP_ROUND_HALF_DOWN の動作を示すサンプルコード。
5 * システムエンジニアを目指す初心者向けに、数値を丸める際の異なる挙動を解説します。
6 */
7function demonstrateRoundingConstants(): void
8{
9    // 丸めの動作を示すための浮動小数点数
10    $value1 = 2.5;
11    $value2 = 3.5;
12    $value3 = -2.5;
13
14    echo "--- PHP_ROUND_HALF_ODD (0.5 の場合、最も近い奇数へ丸める) ---\n";
15    echo "PHP_ROUND_HALF_ODD は、指定された精度で数値を丸める際に、"
16         . "ちょうど中間の値 (例: X.5) の場合に最も近い奇数へ丸めます。\n\n";
17
18    // 2.5 は 2 (偶数) と 3 (奇数) の中間 -> 3 (奇数) へ
19    echo "round({$value1}, 0, PHP_ROUND_HALF_ODD) => " . round($value1, 0, PHP_ROUND_HALF_ODD) . "\n";
20
21    // 3.5 は 3 (奇数) と 4 (偶数) の中間 -> 3 (奇数) へ
22    echo "round({$value2}, 0, PHP_ROUND_HALF_ODD) => " . round($value2, 0, PHP_ROUND_HALF_ODD) . "\n";
23
24    // -2.5 は -2 (偶数) と -3 (奇数) の中間 -> -3 (奇数) へ
25    echo "round({$value3}, 0, PHP_ROUND_HALF_ODD) => " . round($value3, 0, PHP_ROUND_HALF_ODD) . "\n";
26    echo "\n";
27
28    echo "--- PHP_ROUND_HALF_DOWN (0.5 の場合、常に0から遠い方の整数へ切り捨てる) ---\n";
29    echo "PHP_ROUND_HALF_DOWN は、指定された精度で数値を丸める際に、"
30         . "ちょうど中間の値 (例: X.5) の場合に常に切り捨て（0から遠い方の整数へ）ます。\n\n";
31
32    // 2.5 は 2 (切り捨て) へ
33    echo "round({$value1}, 0, PHP_ROUND_HALF_DOWN) => " . round($value1, 0, PHP_ROUND_HALF_DOWN) . "\n";
34
35    // 3.5 は 3 (切り捨て) へ
36    echo "round({$value2}, 0, PHP_ROUND_HALF_DOWN) => " . round($value2, 0, PHP_ROUND_HALF_DOWN) . "\n";
37
38    // -2.5 は -2 (切り捨て) へ
39    echo "round({$value3}, 0, PHP_ROUND_HALF_DOWN) => " . round($value3, 0, PHP_ROUND_HALF_DOWN) . "\n";
40}
41
42// 関数を実行して、各定数の動作を確認
43demonstrateRoundingConstants();
44

このPHPコードは、数値を丸める際に特定のルールを適用するための定数、PHP_ROUND_HALF_ODDとPHP_ROUND_HALF_DOWNの挙動を示すものです。これらの定数は、round()関数の第3引数に指定することで、小数点以下がちょうど0.5の場合の丸め方を詳細に制御します。定数自体は整数値を持ち、丸め処理の指示子として機能します。

PHP_ROUND_HALF_ODDは、指定された精度で数値を丸める際、小数点以下が0.5である場合に最も近い奇数へ丸めるルールを適用します。例えば、2.5は最も近い奇数である3に、3.5も最も近い奇数である3に丸められます。負の数では、-2.5は-3に丸められます。

一方、PHP_ROUND_HALF_DOWNは、小数点以下が0.5である場合に、常に0から遠い方の整数へ切り捨てるルールを適用します。このルールにより、2.5は2に、3.5は3に丸められます。負の数では、-2.5は-2に丸められます。

このように、これらの定数を使い分けることで、ビジネス要件や計算の目的に応じて、小数点以下の数値の扱いを厳密に定義できます。round()関数の戻り値は、指定された丸めルールに基づいて処理された整数となります。