array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.intval.php', 1 => 'intval', ), 'up' => array ( 0 => 'ref.var.php', 1 => 'Funções para Manipulação de variáveis', ), 'prev' => array ( 0 => 'function.gettype.php', 1 => 'gettype', ), 'next' => array ( 0 => 'function.is-array.php', 1 => 'is_array', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/var/functions/intval.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
intval — Obtém o valor em número inteiro de uma variável
Retorta o valor do tipo int do parâmetro value
,
usando a base
especificada para a conversão
(o padrão é base 10). intval() não deve ser usada
em objetos, se isto for feito emitirá um erro de nível E_WARNING
e
retornará 1.
value
O valor escalar a ser convertido para um número inteiro
base
A base para conversão
Nota:
Se
base
for 0, a base usada será determinada pelo formado devalue
:
- se a string incluir um prefixo "0x" (ou "0X"), a base será 16 (hexadecimal); senão,
- se a string começar com um "0b" (ou "0B"), a base será 2 (binária); senão,
- sea string começar com "0", a base será 8 (octal); senão,
- a base será 10 (decimal).
O valor inteiro de value
em caso de sucesso ou 0 em
caso de falhar. Arrays vazios retornam 0, arrays não vazios retornam 1.
O valor máximo depende do sistema. Sistemas de 32 bits têm uma
faixa inteiros com sinal de -2147483648 to 2147483647. Então, por exemplo,
em um sistema desses, intval('1000000000000')
retornará
2147483647. O máximo inteiro com sinal para sistemas de 64 bits é
9223372036854775807.
Strings na maior parte das vezes retornarão 0 embora isso dependa do caractere mais à esquerda dele da string. As regras comuns à conversão para inteiros se aplicam.
Versão | Descrição |
---|---|
8.0.0 |
O nível de erro na conversão de objeto mudou de E_NOTICE para E_WARNING .
|
Exemplo #1 Exemplos de intval()
Os seguintes exemplos são baseados em um sistema de 64 bits.
<?php
echo intval(42); // 42
echo intval(4.2); // 4
echo intval('42'); // 42
echo intval('+42'); // 42
echo intval('-42'); // -42
echo intval(042); // 34
echo intval('042'); // 42
echo intval(1e10); // 10000000000
echo intval('1e10'); // 10000000000
echo intval(0x1A); // 26
echo intval('0x1A'); // 0
echo intval('0x1A', 0); // 26
echo intval(42000000); // 42000000
echo intval(420000000000000000000); // -4275113695319687168
echo intval('420000000000000000000'); // 9223372036854775807
echo intval(42, 8); // 42
echo intval('42', 8); // 34
echo intval(array()); // 0
echo intval(array('foo', 'bar')); // 1
echo intval(false); // 0
echo intval(true); // 1
?>
Nota:
O parâmetro
base
não terá efeito a menos que o parâmetrovalue
seja uma string.