is_finite

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

is_finite — 浮動小数点数の値が、有限の数値であるかどうかを調べる

説明

is_finite(float $num): bool

指定した num が有限の浮動小数点数かどうかを返します。

有限の浮動小数点数とは、NAN (is_nan()) でもなく、かつ無限 (is_infinite()) でもない値です。

パラメータ

num: 調べる float の値。

戻り値

num が NAN, INF, -INF のいずれでもない場合、true を返します。そうでない場合、false を返します。

例

例1 is_finite() の例

<?php
$float = 1.2345;
var_dump($float, is_finite($float));

$nan = sqrt(-1);
var_dump($nan, is_finite($nan));

$inf = 1e308 * 2;
var_dump($inf, is_finite($inf));
?>

上の例の出力は以下となります。

float(1.2345)
bool(true)
float(NAN)
bool(false)
float(INF)
bool(false)

参考

is_infinite() - 浮動小数点数の値が、無限大であるかどうかを調べる
is_nan() - 浮動小数点数の値が、非数かどうかを調べる