ctype_digit
(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)
ctype_digit — Prüft auf Ziffern
Parameter-Liste
-
text -
Der zu prüfende String.
Hinweis:
Wenn ein int zwischen -128 und 255 (inklusive) übergeben wird, wird dieser als ASCII-Wert eines einzelnen Buchstabens interpretiert (zu negativen Werten wird 256 dazu addiert, um Buchstaben des erweiterten ASCII-Zeichensatzes zu erlauben). Alle anderen Integer werden wie eine Zeichenkette interpretiert, welche die dezimalen Ziffern des Integers enthält.
WarnungSeit PHP 8.1.0 ist die Übergabe eines Nicht-String-Arguments veraltet. In Zukunft wird das Argument statt als ASCII-Codepunkt als String interpretiert werden. Je nach beabsichtigtem Verhalten sollte das Argument entweder in String umgewandelt werden, oder es sollte ein expliziter Aufruf von chr() erfolgen.
Rückgabewerte
Gibt true zurück, wenn jedes Zeichen in text
eine Ziffer ist, ansonsten false.
Bei einem Aufruf mit einer leeren Zeichenkette wird immer false zurückgegeben.
Beispiele
Beispiel #1 ctype_digit()-Beispiel
<?php
$strings = array('1820.20', '10002', 'wsl!12');
foreach ($strings as $testcase) {
if (ctype_digit($testcase)) {
echo "Der String $testcase besteht aus Ziffern.\n";
} else {
echo "Der String $testcase enthält nicht nur Ziffern.\n";
}
}
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
Der String 1820.20 enthält nicht nur Ziffern. Der String 10002 besteht aus Ziffern. Der String wsl!12 enthält nicht nur Ziffern.
Beispiel #2 ctype_digit()-Beispiel für den Vergleich von Strings mit ganzen Zahlen
<?php
$numeric_string = '42';
$integer = 42;
ctype_digit($numeric_string); // true
ctype_digit($integer); // false (ASCII 42 ist das Zeichen *)
is_numeric($numeric_string); // true
is_numeric($integer); // true
?>
Siehe auch
- ctype_alnum() - Prüft auf alphanumerische Zeichen
- ctype_xdigit() - Prüft auf Zeichen, die eine Hexadezimalziffer darstellen
- is_numeric() - Prüft, ob eine Variable eine Zahl oder ein numerischer String ist
- is_int() - Prüft, ob eine Variable vom Typ int ist
- is_string() - Prüft, ob Variable vom Typ string ist
