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

    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
    ?>
    ＋add a note
    To Top