ctype_digit

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

ctype_digitCheck for numeric character(s)

Descrierea

ctype_digit ( string $text ) : bool

Checks if all of the characters in the provided string, text, are numerical.

Parametri

text

The tested string.

Valorile întoarse

Returns TRUE if every character in the string text is a decimal digit, FALSE otherwise.

Istoricul schimbărilor

Versiune Descriere
5.1.0 Before PHP 5.1.0, this function returned TRUE when text was an empty string.

Exemple

Example #1 A ctype_digit() example

<?php
$strings 
= array('1820.20''10002''wsl!12');
foreach (
$strings as $testcase) {
    if (
ctype_digit($testcase)) {
        echo 
"The string $testcase consists of all digits.\n";
    } else {
        echo 
"The string $testcase does not consist of all digits.\n";
    }
}
?>

Exemplul de mai sus va afișa:

The string 1820.20 does not consist of all digits.
The string 10002 consists of all digits.
The string wsl!12 does not consist of all digits.

Example #2 A ctype_digit() example comparing strings with integers

<?php

$numeric_string 
'42';
$integer        42;

ctype_digit($numeric_string);  // true
ctype_digit($integer);         // false (ASCII 42 is the * character)

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

Note

Notă:

This function expects a string to be useful, so for example passing in an integer may not return the expected result. However, also note that HTML forms will result in numeric strings and not integers. See also the types section of the manual.

Notă:

Dacă e furnizat un integer cu valoarea între -128 și 255 inclusiv, el este interpretat ca o valoare ASCII a unui singur caracter (valorilor negative li se adaugă 256 pentru a permite caractere din domeniul ASCII extins). Orice alt întreg este interpretat ca un string conținând cifrele zecimale ale întregului.

A se vedea și

  • ctype_alnum() - Check for alphanumeric character(s)
  • ctype_xdigit() - Check for character(s) representing a hexadecimal digit
  • is_numeric() - Determină dacă o variabilă este un număr sau un string numeric
  • is_int() - Determină dacă tipul unei variabile este integer
  • is_string() - Determină dacă tipul variabilei este string