array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.is-numeric.php', 1 => 'is_numeric', ), 'up' => array ( 0 => 'ref.var.php', 1 => 'Funções para Manipulação de variáveis', ), 'prev' => array ( 0 => 'function.is-null.php', 1 => 'is_null', ), 'next' => array ( 0 => 'function.is-object.php', 1 => 'is_object', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/var/functions/is-numeric.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
is_numeric — Verifica se uma variável é um número ou uma string numérica
Determina se a variável fornecida é um número ou uma string numérica.
value
A variável a ser avaliada.
Retorna true
se value
for um número ou uma
string numérica,
false
caso contrário.
Versão | Descrição |
---|---|
8.0.0 |
String numéricas terminando com espaços ("42 " ) agora
retornam true . Anteriormente, false era retornado.
|
Exemplo #1 Exemplos de is_numeric()
<?php
$tests = array(
"42",
1337,
0x539,
02471,
0b10100111001,
1337e0,
"0x539",
"02471",
"0b10100111001",
"1337e0",
"not numeric",
array(),
9.1,
null,
'',
);
foreach ($tests as $element) {
if (is_numeric($element)) {
echo var_export($element, true) . " é numérico", PHP_EOL;
} else {
echo var_export($element, true) . " NÃO é numérico", PHP_EOL;
}
}
?>
O exemplo acima produzirá:
'42' é numérico 1337 é numérico 1337 é numérico 1337 é numérico 1337 é numérico 1337.0 é numérico '0x539' NÃO é numérico '02471' é numérico '0b10100111001' NÃO é numérico '1337e0' é numérico 'not numeric' NÃO é numérico array ( ) NÃO é numérico 9.1 é numérico NULL NÃO é numérico '' NÃO é numérico
Exemplo #2 is_numeric() with whitespace
<?php
$tests = [
" 42",
"42 ",
"\u{A0}9001", // non-breaking space
"9001\u{A0}", // non-breaking space
];
foreach ($tests as $element) {
if (is_numeric($element)) {
echo var_export($element, true) . " é numérico", PHP_EOL;
} else {
echo var_export($element, true) . " NÃO é numérico", PHP_EOL;
}
}
?>
Saída do exemplo acima no PHP 8:
' 42' é numérico '42 ' é numérico ' 9001' NÃO é numérico '9001 ' NÃO é numérico
Saída do exemplo acima no PHP 7:
' 42' é numérico '42 ' NÃO é numérico ' 9001' NÃO é numérico '9001 ' NÃO é numérico