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 optionalen Whitespace-Zeichen, 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,
    "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

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