ctype_cntrl
ctype_graph
Ctype Funktionen
PHP Manual

# ctype_digit

(PHP 4 >= 4.0.4, PHP 5)

ctype_digit — Auf Ziffern überprüfen

### Beschreibung

bool ctype_digit ( string `$text` )

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

ctype_cntrl
ctype_graph
Ctype Funktionen
PHP Manual