dismiss Step into the future! Click here to switch to the beta php.net site
downloads | documentation | faq | getting help | mailing lists | licenses | wiki | reporting bugs | php.net sites | conferences | my php.net

search for in the

lcg_value> <is_infinite
[edit] Last updated: Fri, 28 Jun 2013

view this page in

is_nan

(PHP 4 >= 4.2.0, PHP 5)

is_nanFinds whether a value is not a number

Description

bool is_nan ( float $val )

Checks whether val is 'not a number', like the result of acos(1.01).

Parameters

val

The value to check

Return Values

Returns TRUE if val is 'not a number', else FALSE.

Examples

Example #1 is_nan() example

<?php
// Invalid calculation, will return a 
// NaN value
$nan acos(8);

var_dump($nanis_nan($nan));
?>

The above example will output:

float(NAN)
bool(true)

See Also



lcg_value> <is_infinite
[edit] Last updated: Fri, 28 Jun 2013
 
add a note add a note User Contributed Notes is_nan - [7 notes]
up
2
darkangel at moveinmod dot net
7 years ago
nan/"not a number" is not meant to see if the data type is numeric/textual/etc..

NaN is actually a set of values which can be stored in floating-point variables, but dont actually evaluate to a proper floating point number.

The floating point system has three sections: 1 bit for the sign (+/-), an 8 bit exponent, and a 23 bit fractional part.
There are rules governing which combinations of values can be placed into each section, and some values are reserved for numbers such as infinity. This leads to certain combinations being invalid, or in other words, not a number.
up
1
J.K.
3 years ago
For seeing whether or not something is a number, use ctype_digit().
up
1
Sku
7 years ago
Hi nez,

better would be:

function isNaN( $var ) {
     return !ereg ("^[-]?[0-9]+([\.][0-9]+)?$", $var);
}

ys, Sku
up
1
modern dot apocalypse at gmail dot com
1 year ago
I have decided to do some testing because I am getting unusual results with the is_nan function and here are the results of my tests:

<?php
var_dump
(NAN); // float NAN

var_dump(NAN == NAN); // boolean true
var_dump(NAN === NAN); // boolean true
var_dump(is_nan(NAN)); // boolean true

var_dump(NAN == 12); // boolean true
var_dump(NAN === 12); // boolean false
var_dump(is_nan(12)); // boolean false

var_dump(NAN == 12.4); // boolean true
var_dump(NAN === 12.4); // boolean true
var_dump(is_nan(12.4)); // boolean false

var_dump(NAN == NULL); // boolean true
var_dump(NAN === NULL); // boolean false
var_dump(is_nan(NULL)); // boolean false

var_dump(NAN == 'K<WNPO'); // boolean true
var_dump(NAN === 'K<WNPO'); // boolean false
var_dump(is_nan('K<WNPO')); // null and throws a warning "Warning: is_nan() expects parameter 1 to be double, string given in NANTest.php on line 13"
up
0
php at keith tyler dot com
3 years ago
It seems odd to me, but in boolean context, NAN evalutes to true.

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

Returns:

float(NAN)
bool(true)

Incidentally INF and -INF also evaluate to true.
up
0
nez [at] NOSPAM gazeta [dot] pl
7 years ago
Paul, i guess better would be:

function isNaN( $var ) {
     return ereg ("^[-]?[0-9]+([\.][0-9]+)?$", $var);
}
up
0
Vincent
8 years ago
Since NaN is not even equal to itself, here is a way to test it:

<?php

function my_is_nan($_) {
return (
$_ !== $_);
}

?>

 
show source | credits | stats | sitemap | contact | advertising | mirror sites