is_numeric

(PHP 4, PHP 5, PHP 7)

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

Beschreibung

is_numeric ( mixed $var ) : bool

Prüft, ob die gegebene Variable numerisch ist. Numerische Strings bestehen aus einem optionalen Vorzeichen, einer Anzahl Ziffern, einem optionalen Dezimalteil und einem optionalen Exponentialteil. Folglich ist +0123.45e6 ein gültiger numerischer Wert. Hexadezimale (z.B. 0xf4c3b00c) und binäre (z.B. 0b10100111001) Schreibweise sind nicht erlaubt.

Parameter-Liste

var

Die zu untersuchende Variable.

Rückgabewerte

Gibt TRUE zurück, wenn var eine Zahl oder ein numerischer String ist, ansonsten FALSE.

Beispiele

Beispiel #1 is_numeric()-Beispiele

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

foreach(
$tests as $element) {
    if (
is_numeric($element)) {
        echo 
var_export($elementtrue) . " ist numerisch"PHP_EOL;
    } else {
        echo 
var_export($elementtrue) . " 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 ist numerisch
'nicht numerisch' ist NICHT numerisch
array () ist NICHT numerisch
9.0999999999999996447286321199499070644378662109375 ist numerisch
NULL ist NICHT numerisch

Changelog

Version Beschreibung
7.0.0 Zeichenketten in hexadezimaler Notation (z.B. 0xf4c3b00c) werden nicht länger als numerische Zeichenketten angesehen, d.h. is_numeric() gibt nun FALSE zurück.

Siehe auch

  • ctype_digit() - Auf Ziffern überprüfen
  • 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