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

Copy
1<?php
2
3// 指定されたリファレンス情報に基づき、定数 ABMON_6 を数値として定義します。
4// 「戻り値なし」とは、この定数自体が関数のように値を返さないことを意味します。
5const ABMON_6 = -123.45;
6
7/**
8 * abs() 関数の使用例を示します。
9 * abs() は、与えられた数値の絶対値を返すPHPの組み込み関数です。
10 * 絶対値は、数値を数直線上で0からの距離として表したもので、常に非負の値となります。
11 * 負の数は正になり、正の数はそのままの値が返されます。
12 */
13function demonstrateAbsUsage(): void
14{
15    echo "--- abs() 関数の使用例 ---" . PHP_EOL;
16
17    // 負の整数の絶対値を計算
18    $negativeInteger = -10;
19    echo "元の値: " . $negativeInteger . ", 絶対値: " . abs($negativeInteger) . PHP_EOL;
20
21    // 正の浮動小数点数の絶対値を計算
22    $positiveFloat = 25.75;
23    echo "元の値: " . $positiveFloat . ", 絶対値: " . abs($positiveFloat) . PHP_EOL;
24
25    // 0の絶対値を計算
26    $zeroValue = 0;
27    echo "元の値: " . $zeroValue . ", 絶対値: " . abs($zeroValue) . PHP_EOL;
28
29    // 定数 ABMON_6 の絶対値を計算
30    echo "定数 ABMON_6 の値: " . ABMON_6 . ", 絶対値: " . abs(ABMON_6) . PHP_EOL;
31}
32
33// demonstrateAbsUsage 関数を実行して結果を表示します。
34demonstrateAbsUsage();

このサンプルコードは、PHPの組み込み関数であるabs()（アブソリュート）の使用方法と、定数の定義例を示しています。

abs()関数は、引数として与えられた数値の絶対値を返すために使われる関数です。絶対値とは、数値を数直線上で0からの距離として表したもので、常に0以上の非負の値となります。例えば、-10のような負の数を渡すと10が戻り値として返され、25.75のような正の数を渡すと25.75がそのまま返されます。この関数は、引数として絶対値を求めたい任意の数値を受け取り、その数値の絶対値を非負の数値として返します。

ABMON_6は、このコード内で-123.45という値を持つ定数として定義されています。定数は、一度定義されるとプログラムの実行中にその値が変わることがない、固定された値を保持するものです。「戻り値なし」という説明は、ABMON_6自体が関数のように処理を実行して値を返すものではなく、単に特定の値を保持する入れ物であることを意味します。

コード内のdemonstrateAbsUsage関数は、負の整数、正の浮動小数点数、0、そして定義したABMON_6定数といった様々な値に対してabs()関数を適用し、その計算結果を画面に出力しています。これにより、abs()関数が異なる数値に対してどのように機能し、絶対値が計算されるかという具体的な動作を確認することができます。

Copy
1<?php
2
3// リファレンス情報にある定数ABMON_6を仮に定義します。
4// 実際のPHP環境でABMON_6がどのように定義されているかは、
5// そのエクステンションの状況に依存します。
6// キーワード「文字列」および「abs」との関連性を示すため、
7// ここでは数値として解釈可能な文字列として定義しています。
8if (!defined('ABMON_6')) {
9    define('ABMON_6', '-98.76');
10}
11
12/**
13 * PHPのabs()関数が文字列引数をどのように処理するかを示す関数。
14 * システムエンジニアを目指す初心者向けに、数値文字列の絶対値計算と、
15 * 非数値文字列の挙動を簡潔にデモンストレーションします。
16 */
17function demonstrateAbsWithString(): void
18{
19    echo "--- PHP abs() 関数と文字列の挙動のデモンストレーション ---" . PHP_EOL . PHP_EOL;
20
21    // 1. 負の整数を表す文字列の例
22    $negativeIntegerString = "-100";
23    // abs() 関数に文字列を渡すと、PHPは自動的に数値を抽出して型変換を試みます。
24    $absOfNegativeInteger = abs($negativeIntegerString);
25    echo "文字列 '{$negativeIntegerString}' の絶対値: {$absOfNegativeInteger}" . PHP_EOL;
26
27    // 2. 負の浮動小数点数を表す文字列の例
28    $negativeFloatString = "-25.5";
29    $absOfNegativeFloat = abs($negativeFloatString);
30    echo "文字列 '{$negativeFloatString}' の絶対値: {$absOfNegativeFloat}" . PHP_EOL;
31
32    // 3. リファレンス情報にある定数ABMON_6を文字列として利用する例
33    // 定義したABMON_6が数値として解釈できる文字列であると仮定し、その絶対値を計算します。
34    if (is_numeric(ABMON_6)) {
35        $absOfConstant = abs(ABMON_6);
36        echo "定数 ABMON_6 の値 ('" . ABMON_6 . "') の絶対値: {$absOfConstant}" . PHP_EOL;
37    } else {
38        echo "注意: 定数 ABMON_6 は数値として解釈できない形式です。" . PHP_EOL;
39    }
40
41    // 4. 数値として解釈できない文字列の場合
42    $nonNumericString = "helloPHP";
43    // abs() 関数は、数値として解釈できない文字列に対しては、
44    // PHP 8では E_WARNING (警告) を発生させ、0を返します。
45    // 実際のアプリケーションでは、このような文字列を渡す前に型チェックを行うことを強く推奨します。
46    $absOfNonNumeric = abs($nonNumericString);
47    echo "数値ではない文字列 '{$nonNumericString}' の絶対値: {$absOfNonNumeric}" . PHP_EOL; // 警告と共に 0 が出力されます
48    echo PHP_EOL;
49    echo "--- デモンストレーション終了 ---" . PHP_EOL;
50}
51
52// サンプル関数の実行
53demonstrateAbsWithString();

PHPのabs()関数は、引数として与えられた数値の絶対値を計算する関数です。この関数に文字列を渡した場合、PHPは内部的にその文字列を数値に自動変換しようと試みます。

例えば、-100や-25.5のように負の数値を表す文字列を引数に指定すると、abs()関数はこれらを数値として解釈し、それぞれ100や25.5といった正の絶対値を返します。サンプルコード内では、仮に-98.76という数値文字列として定義された定数ABMON_6に対しても同様に絶対値が計算され、98.76が返される様子を示しています。

しかし、"helloPHP"のように数値として全く解釈できない文字列が引数として渡された場合、PHP 8ではE_WARNING（警告）が発生し、結果として0が返されます。このような予期しない挙動を防ぐため、abs()関数に文字列を渡す際は、事前にis_numeric()などの関数でその文字列が数値として有効かを確認することが推奨されます。

abs()関数は、数値または数値に変換可能な文字列を引数として受け取り、常に非負の数値（絶対値）を戻り値として返します。