PHPのis_nan()関数とは？NaN（非数）判定の使い方とサンプルコードを解説

is_nan()関数とは

PHPのis_nan()関数は、指定した値が「NaN（Not a Number：非数）」であるかどうかを判定するための関数です。引数に渡した値が非数であればTRUEを、そうでなければFALSEを返します。

NaNは、数学的に定義できない演算（例：負の数の平方根や、定義域外の値に対する三角関数の計算など）の結果として現れる特殊な浮動小数点値です。数値処理を行うプログラムでは、異常な計算結果を検出するためにこの関数がよく活用されます。

構文

is_nan(num)

パラメータ

• num − NaNかどうかをチェックする対象の値

戻り値

numが「非数（NaN）」であればTRUEを、それ以外の場合はFALSEを返します。

使用例1：通常の数値をチェックする

<?php
    var_dump(is_nan(10));
?>

10は通常の数値なので、結果はFALSEとなります。

出力：

bool(false)

使用例2：acos()関数と組み合わせる

次に、逆余弦を求めるacos()関数と組み合わせた例を見てみましょう。acos(1)の計算結果は0であり、これはNaNではないためFALSEが返されます。

<?php
    var_dump(is_nan(acos(1)));
?>

出力：

bool(false)

補足：NaNが発生するケース

acos()関数に定義域外の値（-1〜1の範囲外）を渡すと、結果はNaNになります。例えば以下のコードではTRUEが返されます。

<?php
    var_dump(is_nan(acos(8)));
?>

出力：

bool(true)

このように、is_nan()関数を使うことで、計算結果が有効な数値であるかどうかを簡単に確認でき、予期しない数値エラーの防止に役立ちます。