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', 2 => 'Verifica se uma variável é um número ou uma string numérica', ), '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', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

is_numeric

(PHP 4, PHP 5, PHP 7, PHP 8)

is_numeric — Verifica se uma variável é um número ou uma string numérica

Descrição

is_numeric(mixed $value): bool

Determina se a variável fornecida é um número ou uma string numérica.

Parâmetros

value

A variável a ser avaliada.

Valor Retornado

Retorna true se value for um número ou uma string numérica, false caso contrário.

Registro de Alterações

Versão Descrição
8.0.0 String numéricas terminando com espaços ("42 ") agora retornam true. Anteriormente, false era retornado.

Exemplos

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() com espaço em branco

<?php
$tests = [
" 42",
"42 ",
"\u{A0}9001", // caractere de espaço sem quebra
"9001\u{A0}", // caractere de espaço sem quebra
];

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

Veja Também