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() - 浮動小数点数の値が、非数かどうかを調べる

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 1 note

down

Daniel Klein ¶

7 years ago

(is_finite($float)) is equivalent to (!is_infinite($float) && !is_nan($float)), i.e. a number can only be one of finite, infinite and NaN. You don't need to check both is_infinite() and is_nan() to see if a number is invalid or out of range.

<?php
$finite = 42;
$infinite = log(0);
$nan = acos(2);

var_dump(is_finite($finite), is_infinite($finite), is_nan($finite));  // true, false, false
var_dump(is_finite($infinite), is_infinite($infinite), is_nan($infinite));  // false, true, false
var_dump(is_finite($nan), is_infinite($nan), is_nan($nan)); // false, false, true
?>

＋add a note