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

Copy
1<?php
2
3/**
4 * PHPが数値の特殊な状態（Not a Number, NAN）をどのように扱えるかを示します。
5 * NANは「数値ではない」ことを意味する浮動小数点数で、数学的に不定な結果（例: 0/0）
6 * や無効な操作（例: 負の数の平方根）から生じることがあります。
7 * この関数は、PHPがこのような特殊な数値状態を検出し、処理できることを示します。
8 */
9function demonstrateNanHandling(): void
10{
11    echo "--- PHPでの特殊な浮動小数点数 (NAN) の扱い ---" . PHP_EOL . PHP_EOL;
12
13    // PHPの組み込み定数 NAN を直接利用します。
14    // NANは、"Not a Number"（数値ではない）を意味します。
15    $nanConstant = NAN;
16    echo "PHPの組み込み定数 NAN の値: " . $nanConstant . PHP_EOL;
17    echo "この値は浮動小数点数か？ " . (is_float($nanConstant) ? "はい" : "いいえ") . PHP_EOL;
18    echo "この値は NAN か？ " . (is_nan($nanConstant) ? "はい" : "いいえ") . PHP_EOL . PHP_EOL;
19
20    // 数学的にNANが発生する典型的な例：0を0で割る
21    $resultOfDivision = 0 / 0;
22    echo "0 / 0 の計算結果: " . $resultOfDivision . PHP_EOL;
23    echo "結果は NAN か？ " . (is_nan($resultOfDivision) ? "はい" : "いいえ") . PHP_EOL . PHP_EOL;
24
25    // 数学的にNANが発生する別の例：負の数の対数
26    // `log()` 関数は負の値に対して NAN を返します。
27    $resultOfLog = log(-1);
28    echo "log(-1) の計算結果: " . $resultOfLog . PHP_EOL;
29    echo "結果は NAN か？ " . (is_nan($resultOfLog) ? "はい" : "いいえ") . PHP_EOL . PHP_EOL;
30
31    // NANは、自分自身を含め、いかなる値とも等しくありません。
32    // NANかどうかを判断するには、常に `is_nan()` 関数を使用する必要があります。
33    echo "NAN == NAN の比較結果: " . (NAN == NAN ? "true" : "false") . PHP_EOL;
34    echo "NAN === NAN の比較結果: " . (NAN === NAN ? "true" : "false") . PHP_EOL;
35    echo "is_nan(NAN) のチェック: " . (is_nan(NAN) ? "true" : "false") . PHP_EOL;
36}
37
38// 関数を実行し、PHPが数値の特殊な状態をどのように扱えるかを示します。
39demonstrateNanHandling();

PHPのNANは、「Not a Number」（数値ではない）を意味する特別な浮動小数点数を表す組み込み定数です。これは引数を持たず、直接float型の値として使用されます。主に、数学的に定義できない計算結果、例えば「0を0で割る」といった不定な操作や、「負の数の対数を取る」のような無効な操作が行われた場合に発生します。

PHPは、このNAN定数を通じて、通常の数値では表現できない特殊な状態を扱うことができます。これにより、計算結果が不正になった場合でも、プログラムが予期せぬエラーで停止することなく、その状態を検出して適切な処理を行うことが可能になります。

サンプルコードでは、PHPがNAN定数を直接提供していることと、「0/0」や「log(-1)」などの計算がNANを返す様子を示しています。NANの重要な特性として、自分自身を含め、他のいかなる値とも等しくないという点があります。そのため、ある値がNANであるかどうかを判定するには、通常の比較演算子ではなく、専用のis_nan()関数を使用する必要があります。このように、PHPは数値計算における特殊な状態を正確に識別し、堅牢なシステムを構築するための機能を提供しています。

Copy
1<?php
2
3/**
4 * PHPの特殊な浮動小数点値であるNAN (Not A Number) の使用例を示します。
5 * NANは、不定または表現不可能な数値結果を表す定数です。
6 *
7 * (初心者向け補足) PHPは「PHP: Hypertext Preprocessor」の略であり、
8 * 元々は「Personal Home Page Tools」という意味でした。
9 */
10function demonstrateNanConstant(): void
11{
12    // PHPに組み込まれているNAN定数
13    // これは float 型の特殊な値です
14    $notANumber = NAN;
15
16    echo "NAN定数の値: ";
17    var_dump($notANumber); // float(NAN) と表示されます
18
19    // NANは、自分自身を含め、他のどの値とも等しくないと評価される特殊な性質を持ちます。
20    // そのため、通常の比較演算子 (==) でNANかどうかを判定することはできません。
21    echo "NAN == NAN の比較結果: ";
22    var_dump($notANumber == $notANumber); // 結果は false
23
24    // NANかどうかを正確にチェックするには、is_nan() 関数を使用します。
25    echo "is_nan(NAN) のチェック結果: ";
26    var_dump(is_nan($notANumber)); // 結果は true
27
28    // NANが発生する一般的なケースの例:
29    // 数学的に定義されていない操作の結果としてNANが生成されることがあります。
30    // 例: acos() 関数は引数が -1 から 1 の範囲外の場合、NANを返します。
31    $invalidOperationResult = acos(2.0);
32    echo "acos(2.0) の結果: ";
33    var_dump($invalidOperationResult); // float(NAN)
34    echo "is_nan(acos(2.0)) のチェック結果: ";
35    var_dump(is_nan($invalidOperationResult)); // 結果は true
36
37    // 通常の数値や無限大 (INF) はNANではありません
38    echo "is_nan(123.45) のチェック結果: ";
39    var_dump(is_nan(123.45)); // 結果は false
40
41    echo "is_nan(INF) (無限大) のチェック結果: ";
42    var_dump(is_nan(INF)); // 結果は false
43}
44
45// 関数を実行して、NANの動作を確認します
46demonstrateNanConstant();
47
48?>

PHPは「PHP: Hypertext Preprocessor」の略で、ウェブ開発で広く使われるプログラミング言語です。PHP 8で利用できるNANは、Not A Numberの略で、浮動小数点数（float型）において不定または表現不可能な数値結果を表す特殊な定数です。この定数には引数はなく、常にfloat型の値を返します。

NANは非常に特殊な性質を持っており、自分自身を含め、他のどの値とも等しいとは評価されません。そのため、通常の==のような比較演算子を使って変数がNANであるかを判定することはできません。変数がNANであるかを正確に確認するためには、is_nan()関数を使用する必要があります。

NANは、数学的に定義されていない操作の結果として発生することがあります。例えば、acos()関数に引数が-1から1の範囲外の数値を与えた場合（例: acos(2.0)）、結果としてNANが返されます。サンプルコードでは、このNANの動作と、is_nan()関数を用いた正しい判定方法、そして通常の数値や無限大（INF）がNANではないことが示されています。