【PHP8.x】is_nan関数の使い方

Copy
1<?php
2
3/**
4 * 指定された値が NaN (Not-a-Number) であるかどうかを判定する。
5 *
6 * @param float $num 判定する値
7 * @return bool NaN であれば true、そうでなければ false
8 */
9function check_nan(float $num): bool
10{
11    return is_nan($num);
12}
13
14// 使用例
15$nan_value = acos(8); // 定義域外の値を計算して NaN を生成
16$infinity_value = INF;
17$normal_value = 10.5;
18
19echo "NaN value: " . var_export(check_nan($nan_value), true) . PHP_EOL; // 出力: NaN value: true
20echo "Infinity value: " . var_export(check_nan($infinity_value), true) . PHP_EOL; // 出力: Infinity value: false
21echo "Normal value: " . var_export(check_nan($normal_value), true) . PHP_EOL; // 出力: Normal value: false

PHPのis_nan()関数は、与えられた数値が「NaN (Not a Number)」であるかどうかを判定するために使用されます。NaNとは、数値として表現できない値を指し、例えば、数学的に定義されていない演算の結果などが該当します。

この関数は、引数としてfloat型の数値 $num を受け取ります。is_nan($num) は、$num が NaN であれば true を、そうでなければ false を返します。

サンプルコードでは、check_nan() という関数を定義し、is_nan() 関数を利用して、与えられた数値が NaN であるかどうかを判定しています。acos(8) は、定義域外の値を計算するため、NaN を生成します。INF は無限大を表す定数です。

実行結果からわかるように、is_nan() 関数は、NaN に対してのみ true を返し、無限大や通常の数値に対しては false を返します。この関数は、数値計算の結果を検証し、予期せぬエラーを回避するために役立ちます。特に、ユーザーからの入力値を元に計算を行う場合など、入力値が数値として適切かどうかを検証する際に有効です。

Copy
1<?php
2
3/**
4 * Checks if a value is NaN (Not a Number).
5 *
6 * @param float $num The value to check.
7 * @return bool True if $num is NaN, false otherwise.
8 */
9function check_nan(float $num): bool
10{
11  return is_nan($num);
12}
13
14// Example usage:
15$nan_value = acos(8); // Generate a NaN value.
16$regular_number = 10.5;
17
18echo "Is NaN: " . (check_nan($nan_value) ? 'yes' : 'no') . PHP_EOL;
19echo "Is NaN: " . (check_nan($regular_number) ? 'yes' : 'no') . PHP_EOL;

PHPのis_nan()関数は、与えられた数値が「Not a Number (NaN)」であるかどうかを判定します。NaNとは、数値として表現できない値を表す特別な値で、例えば、定義域外の数学関数（例：負の数の平方根や、acos(8)のように絶対値が1より大きい数の逆余弦）の結果などがNaNとなります。

このサンプルコードでは、check_nan()という関数を定義し、is_nan()関数を利用して、引数として受け取った浮動小数点数 $num がNaNであるかどうかを判定しています。is_nan($num) は、$num がNaNの場合には true を、そうでない場合には false を返します。

サンプルコードでは、まず acos(8) を実行し、NaNとなる値を $nan_value に代入しています。次に、通常の浮動小数点数 10.5 を $regular_number に代入しています。そして、それぞれの変数に対して check_nan() 関数を呼び出し、結果をターナリー演算子 (condition ? value_if_true : value_if_false) を用いて "yes" または "no" の文字列に変換し、画面に出力しています。これにより、is_nan() 関数がNaN値を正しく判定できることを確認できます。この例では、$nan_value はNaNなので "Is NaN: yes" と出力され、 $regular_number は通常の数値なので "Is NaN: no" と出力されます。