ctype_digit

(PHP 4 >= 4.0.4, PHP 5, PHP 7)

ctype_digitAuf Ziffern überprüfen

Beschreibung

ctype_digit ( string $text ) : bool

Prüft ob der übergebene String nur aus Ziffern besteht.

Parameter-Liste

text

Der zu prüfende String.

Rückgabewerte

Liefert TRUE wenn jedes Zeichen in text eine Ziffer ist, ansonsten FALSE.

Changelog

Version Beschreibung
5.1.0 Vor PHP 5.1.0 gab die Funktion auch TRUE zurück wenn der Eingabestring komplett leer war.

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 A ctype_digit() example comparing strings with integers

<?php

$numeric_string 
'42';
$integer        42;

ctype_digit($numeric_string);  // true
ctype_digit($integer);         // false

is_numeric($numeric_string);   // true
is_numeric($integer);          // true
?>

Anmerkungen

Hinweis:

Diese Funktion ist nur sinnvoll wenn der Eingabeparameter ein string ist, ein integer Wert als Eingabe wird immer FALSE als Ergebnis liefern. Da auch numerische HTML-Formulareingaben immer als String übergeben werden hat die Funktion hier dennoch ihren Sinn. Siehe auch den types Abschnitt des Handbuchs.

Hinweis:

Wenn ein integer 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 ein String interpretiert, welcher die dezimalen Ziffern des Integers enthält.

Siehe auch

  • ctype_alnum() - Auf alphanumerische Zeichen überprüfen
  • ctype_xdigit() - Auf Hexadezimalziffern überprüfen
  • 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