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

Copy
1<?php
2
3/**
4 * PHP_ROUND_HALF_DOWN 定数を使用した数値の丸め処理をデモンストレーションします。
5 *
6 * この丸めモードは、数値がちょうど中間点 (例: X.5, Y.05) にある場合に適用されます。
7 *
8 * 具体的な挙動の例 (小数点以下0桁に丸める場合):
9 * - 正の数: X.5 は X に丸められます (例: 2.5 は 2)。
10 * - 負の数: -X.5 は -(X+1) に丸められます (例: -2.5 は -3)。
11 *   これは、絶対値が大きくなる方向、つまり0から遠ざかる方向に丸められることを意味します。
12 */
13function demonstrateRoundHalfDown(): void
14{
15    echo "--- PHP_ROUND_HALF_DOWN 定数による丸め処理 ---" . PHP_EOL . PHP_EOL;
16
17    // --- 小数点以下0桁に丸める例 ---
18
19    $positiveNumber1 = 2.5;
20    echo "対象数値: " . $positiveNumber1 . PHP_EOL;
21    // 2.5 は正の数の中間点なので、2 に丸められます。
22    echo "  丸め後: " . round($positiveNumber1, 0, PHP_ROUND_HALF_DOWN) . PHP_EOL . PHP_EOL;
23
24    $positiveNumber2 = 3.5;
25    echo "対象数値: " . $positiveNumber2 . PHP_EOL;
26    // 3.5 も正の数の中間点なので、3 に丸められます。
27    echo "  丸め後: " . round($positiveNumber2, 0, PHP_ROUND_HALF_DOWN) . PHP_EOL . PHP_EOL;
28
29    $positiveNumber3 = 2.4;
30    echo "対象数値: " . $positiveNumber3 . PHP_EOL;
31    // 2.4 は中間点ではないため、通常の丸め（四捨五入）と同様に 2 に丸められます。
32    echo "  丸め後: " . round($positiveNumber3, 0, PHP_ROUND_HALF_DOWN) . PHP_EOL . PHP_EOL;
33
34    $positiveNumber4 = 2.6;
35    echo "対象数値: " . $positiveNumber4 . PHP_EOL;
36    // 2.6 は中間点ではないため、通常の丸め（四捨五入）と同様に 3 に丸められます。
37    echo "  丸め後: " . round($positiveNumber4, 0, PHP_ROUND_HALF_DOWN) . PHP_EOL . PHP_EOL;
38
39    $negativeNumber1 = -2.5;
40    echo "対象数値: " . $negativeNumber1 . PHP_EOL;
41    // -2.5 は負の数の中間点なので、-3 に丸められます (0から遠い方へ)。
42    echo "  丸め後: " . round($negativeNumber1, 0, PHP_ROUND_HALF_DOWN) . PHP_EOL . PHP_EOL;
43
44    $negativeNumber2 = -3.5;
45    echo "対象数値: " . $negativeNumber2 . PHP_EOL;
46    // -3.5 も負の数の中間点なので、-4 に丸められます (0から遠い方へ)。
47    echo "  丸め後: " . round($negativeNumber2, 0, PHP_ROUND_HALF_DOWN) . PHP_EOL . PHP_EOL;
48
49    // --- 小数点以下の桁数を指定して丸める例 ---
50
51    $decimalNumber1 = 123.45;
52    echo "対象数値: " . $decimalNumber1 . PHP_EOL;
53    // 小数点第2位の '5' が中間点なので、正の数のルールに従い 123.4 に丸められます。
54    echo "  小数点第1位に丸め後: " . round($decimalNumber1, 1, PHP_ROUND_HALF_DOWN) . PHP_EOL . PHP_EOL;
55
56    $decimalNumber2 = 123.55;
57    echo "対象数値: " . $decimalNumber2 . PHP_EOL;
58    // 小数点第2位の '5' が中間点なので、正の数のルールに従い 123.5 に丸められます。
59    echo "  小数点第1位に丸め後: " . round($decimalNumber2, 1, PHP_ROUND_HALF_DOWN) . PHP_EOL . PHP_EOL;
60
61    $decimalNumber3 = 123.46;
62    echo "対象数値: " . $decimalNumber3 . PHP_EOL;
63    // 小数点第2位が '6' で中間点ではないため、通常の丸め（四捨五入）と同様に 123.5 に丸められます。
64    echo "  小数点第1位に丸め後: " . round($decimalNumber3, 1, PHP_ROUND_HALF_DOWN) . PHP_EOL . PHP_EOL;
65}
66
67// デモンストレーション関数を実行します。
68demonstrateRoundHalfDown();

PHP_ROUND_HALF_DOWNは、PHPのround()関数で使用される定数の一つで、数値を特定のルールで丸める際の挙動を指定します。この定数は、丸めたい数値がちょうど中間点（例えば、小数点以下を0桁に丸める際のX.5や、小数点第1位に丸める際のX.Y5など）にある場合に適用される丸めモードを定義します。

round()関数は、最初の引数に丸めたい数値を、2番目の引数に小数点以下の桁数（デフォルトは0）、3番目の引数にこの丸めモード定数を指定して使用します。戻り値は丸められた数値です。

PHP_ROUND_HALF_DOWNモードを指定した場合、数値がちょうど中間点にあるとき、正の数では小さい方の整数（0に近づく方向）に丸められます。例えば、2.5は2に丸められます。一方、負の数では大きい方の整数（0から遠ざかる方向）に丸められます。例えば、-2.5は-3に丸められます。中間点ではない数値に対しては、通常の四捨五入と同様の挙動を示します。

サンプルコードでは、様々な正と負の数に対してPHP_ROUND_HALF_DOWNを適用し、その丸め処理の結果を確認しています。特に、2.5が2に、-2.5が-3になるという、この定数特有の挙動や、小数点以下の桁数を指定した場合の丸め方も具体的に示されており、定数の動作を正確に理解することができます。

Copy
1<?php
2
3/**
4 * PHPの数値丸めモード PHP_ROUND_HALF_DOWN と PHP_ROUND_HALF_EVEN の動作をデモンストレーションします。
5 *
6 * この関数は、特定の数値に対して異なる丸めモードを適用し、
7 * その結果を出力することで、それぞれの丸めルールの違いを示します。
8 * システムエンジニアを目指す初心者が数値の丸め処理を理解するのに役立ちます。
9 */
10function demonstrateRoundingModes(): void
11{
12    echo "PHPの数値丸めモードのデモンストレーション\n";
13    echo "--------------------------------------\n\n";
14
15    // 丸めの対象となる数値の配列
16    // .5 の値は各モードの挙動を理解する上で重要です。
17    $numbersToRound = [
18        2.5,   // 整数部分が偶数
19        3.5,   // 整数部分が奇数
20        2.7,   // .5 より大きい
21        2.3,   // .5 より小さい
22        -2.5,  // 負の数で .5
23        -3.5   // 負の数で .5
24    ];
25
26    echo "対象数値: " . implode(", ", $numbersToRound) . "\n\n";
27
28    // --- PHP_ROUND_HALF_DOWN ---
29    // 半分の値 (X.5) は常に絶対値が小さくなる方向に丸められます（つまり切り捨て）。
30    echo "--- PHP_ROUND_HALF_DOWN (半分の値は常に切り捨て) ---\n";
31    foreach ($numbersToRound as $num) {
32        // round() 関数の第三引数に PHP_ROUND_HALF_DOWN を指定
33        $roundedValue = round($num, 0, PHP_ROUND_HALF_DOWN);
34        echo sprintf("round(%.1f, 0, PHP_ROUND_HALF_DOWN) = %d\n", $num, $roundedValue);
35    }
36    echo "\n";
37
38    // --- PHP_ROUND_HALF_EVEN ---
39    // 半分の値 (X.5) は最も近い偶数に丸められます。
40    // 例: 2.5 は 2 に、3.5 は 4 に丸められます。
41    echo "--- PHP_ROUND_HALF_EVEN (半分の値は最も近い偶数に丸める) ---\n";
42    foreach ($numbersToRound as $num) {
43        // round() 関数の第三引数に PHP_ROUND_HALF_EVEN を指定
44        $roundedValue = round($num, 0, PHP_ROUND_HALF_EVEN);
45        echo sprintf("round(%.1f, 0, PHP_ROUND_HALF_EVEN) = %d\n", $num, $roundedValue);
46    }
47    echo "\n";
48}
49
50// デモンストレーション関数を実行します。
51demonstrateRoundingModes();

PHPのPHP_ROUND_HALF_DOWNは、数値を丸める際の挙動を定義する定数の一つです。この定数は主にround()関数の第三引数に指定し、小数部がちょうど0.5の場合に、絶対値が小さくなる方向（つまり、ゼロに近づく方向）に数値を丸めるモードを示します。例えば、2.5は2に、-2.5は-2になります。この定数自体は引数や戻り値を持たず、特定の丸めルールを識別するための値として機能します。

一方、PHP_ROUND_HALF_EVENも同様にround()関数で使用される丸めモードの定数で、小数部がちょうど0.5の場合に、最も近い偶数に数値を丸めるというルールを適用します。具体的には、2.5は2に、3.5は4に、-2.5は-2に丸められます。

提供されたサンプルコードでは、様々な正負の小数を含む数値の配列に対して、PHP_ROUND_HALF_DOWNとPHP_ROUND_HALF_EVENのそれぞれの丸めモードを適用した結果を比較して表示しています。これにより、両者の丸めルールの違い、特に小数部が0.5の数値がどのように処理されるかが具体的に理解できます。システムエンジニアを目指す初心者が数値処理の基礎として、PHPにおける丸めモードの選択肢とその具体的な挙動を把握するのに役立ちます。