is_numeric

(PHP 4, PHP 5, PHP 7, PHP 8)

is_numeric — Prüft, ob eine Variable eine Zahl oder ein numerischer String ist

Beschreibung

is_numeric(mixed $value): bool

Prüft, ob die gegebene Variable eine Zahl oder ein numerischer String ist.

Parameter-Liste

value: Die zu untersuchende Variable

Rückgabewerte

Gibt true zurück, wenn value eine Zahl oder ein numerischer String ist, ansonsten false.

Changelog

Version	Beschreibung
8.0.0	Numerische Strings, die mit einem Leerzeichen enden (`"42 "`), geben nun `true` zurück. Zuvor wurde stattdessen `false` zurückgegeben.

Beispiele

Beispiel #1 is_numeric()-Beispiele

<?php
$tests = array(
    "42",
    1337,
    0x539,
    02471,
    0b10100111001,
    1337e0,
    "0x539",
    "02471",
    "0b10100111001",
    "1337e0",
    "nicht numerisch",
    array(),
    9.1,
    null,
    '',
);

foreach ($tests as $element) {
    if (is_numeric($element)) {
        echo var_export($element, true) . " ist numerisch", PHP_EOL;
    } else {
        echo var_export($element, true) . " ist NICHT numerisch", PHP_EOL;
    }
}
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

'42' ist numerisch
1337 ist numerisch
1337 ist numerisch
1337 ist numerisch
1337 ist numerisch
1337.0 ist numerisch
'0x539' ist NICHT numerisch
'02471' ist numerisch
'0b10100111001' ist NICHT numerisch
'1337e0' ist numerisch
'nicht numerisch' ist NICHT numerisch
array (
) ist NICHT numerisch
9.1 ist numerisch
NULL ist NICHT numerisch
'' ist NICHT numerisch

Beispiel #2 is_numeric() mit Leerzeichen

<?php
$tests = [
    " 42",
    "42 ",
    "\u{A0}9001", // nicht umbrechendes Leerzeichen
    "9001\u{A0}", // nicht umbrechendes Leerzeichen
];

foreach ($tests as $element) {
    if (is_numeric($element)) {
        echo var_export($element, true) . " ist numerisch", PHP_EOL;
    } else {
        echo var_export($element, true) . " ist NICHT numerisch", PHP_EOL;
    }
}
?>

Das oben gezeigte Beispiel erzeugt mit PHP 8 folgende Ausgabe:

' 42' ist numerisch
'42 ' ist numerisch
' 9001' ist NICHT numerisch
'9001 ' ist NICHT numerisch

Das oben gezeigte Beispiel erzeugt mit PHP 7 folgende Ausgabe:

' 42' ist numerisch
'42 ' ist NICHT numerisch
' 9001' ist NICHT numerisch
'9001 ' ist NICHT numerisch

Siehe auch

Numerische Strings
ctype_digit() - Prüft auf Ziffern
is_bool() - Prüft, ob eine Variable vom Typ boolean ist
is_null() - Prüft, ob eine Variable null enthält
is_float() - Prüft, ob eine Variable vom Typ float ist
is_int() - Prüft, ob eine Variable vom Typ int ist
is_string() - Prüft, ob Variable vom Typ string ist
is_object() - Prüft, ob eine Variable vom Typ object ist
is_array() - Prüft, ob die Variable ein Array ist
filter_var() - Filtert eine Variable mit einem angegebenen Filter

Found A Problem?

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

＋add a note

User Contributed Notes 7 notes

down

sobolanx at gmail dot com ¶

13 years ago

Note that the function accepts extremely big numbers and correctly evaluates them.

For example:

<?php
    $v = is_numeric ('58635272821786587286382824657568871098287278276543219876543') ? true : false;
    
    var_dump ($v);
?>

The above script will output:

bool(true)

So this function is not intimidated by super-big numbers. I hope this helps someone.

PS: Also note that if you write is_numeric (45thg), this will generate a parse error (since the parameter is not enclosed between apostrophes or double quotes). Keep this in mind when you use this function.

down

tanguy_barsik at hotmail dot com ¶

7 years ago

for strings, it return true only if float number has a dot

is_numeric( '42.1' )//true
is_numeric( '42,1' )//false

down

moskalyuk at gmail dot com ¶

18 years ago

is_numeric fails on the hex values greater than LONG_MAX, so having a large hex value parsed through is_numeric would result in FALSE being returned even though the value is a valid hex number

down

ben at chico dot com ¶

10 years ago

Apparently NAN (Not A Number) is a number for the sake of is_numeric(). 

<?php 
echo "is "; 
if (!is_numeric(NAN)) 
 echo "not "; 
 echo "a number"; 
?> 

Outputs "is a number". So something that is NOT a number (by defintion) is a number...

down

kouber at saparev dot com ¶

21 years ago

Note that this function is not appropriate to check if "is_numeric" for very long strings. In fact, everything passed to this function is converted to long and then to a double. Anything greater than approximately 1.8e308 is too large for a double, so it becomes infinity, i.e. FALSE. What that means is that, for each string with more than 308 characters, is_numeric() will return FALSE, even if all chars are digits.

However, this behaviour is platform-specific.

http://www.php.net/manual/en/language.types.float.php

In such a case, it is suitable to use regular expressions:

function is_numeric_big($s=0) {
  return preg_match('/^-?\d+$/', $s);
}

down

Magnus Deininger, dma05 at web dot de ¶

15 years ago

regarding the global vs. american numeral notations, it should be noted that at least in japanese, numbers aren't grouped with an extra symbol every three digits, but rather every four digits (for example 1,0000 instead of 10.000). also nadim's regexen are slightly suboptimal at one point having an unescaped '.' operator, and the whole thing could easily be combined into a single regex (speed and all).



adjustments:



<?php

$eng_or_world = preg_match

  ('/^[+-]?'. // start marker and sign prefix

  '(((([0-9]+)|([0-9]{1,4}(,[0-9]{3,4})+)))?(\\.[0-9])?([0-9]*)|'. // american

  '((([0-9]+)|([0-9]{1,4}(\\.[0-9]{3,4})+)))?(,[0-9])?([0-9]*))'. // world

  '(e[0-9]+)?'. // exponent

  '$/', // end marker

  $str) == 1;

?>



i'm sure this still isn't optimal, but it should also cover japanese-style numerals and it fixed a couple of other issues with the other regexen. it also allows for an exponent suffix, the pre-decimal digits are optional and it enforces using either grouped or ungrouped integer parts. should be easier to trim to your liking too.

down

Katrina Kizenbach ¶

2 years ago

Note that is_numeric() will evaluate to false for number strings using decimal commas.

is_numeric('0.11');
Output: true

is_numeric('0,11');
Output: false

＋add a note