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 の値。

戻り値

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

add a note

User Contributed Notes 1 note

up
9
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
?>
To Top