empty
(PHP 4, PHP 5)
empty — Informa se a variável é vazia
Descrição
Determina se a variável é considerada vazia.
Parâmetros
- var
-
Variável a ser verificada
Nota: empty() somente verifica variáveis, qualquer outra coisa então irá resultar em um parse error. Em outras palavras, o seguinte não irá funcionar: empty(trim($name)).
empty() é o oposto de (boolean) var, com exceção de não gerar um alerta (warning) se a variável não existir.
Valor Retornado
Retorna FALSE se var não for vazia e valor diferente de zero.
O que é visto abaixo é considerado vazio:
- "" (an empty string)
- 0 (0 as an integer)
- "0" (0 as a string)
- NULL
- FALSE
- array() (an empty array)
- var $var; (a variable declared, but without a value in a class)
Histórico
| Versão | Descrição |
|---|---|
| PHP 5 |
No PHP 5, objetos sem propriedades não são mais considerado vazio. |
| PHP 4 |
No PHP 4, a string "0" é considerada vazia. |
Exemplos
Example#1 Uma simples comparação entre as funções empty() / isset().
<?php
$var = 0;
// Será interpretado como true, porque $var é um valor vazio
if (empty($var)) {
echo '$var é um dos valores: 0, empty ou uma variável inexistente';
}
// Será interpretado como true porque $var está 'setado'
if (isset($var)) {
echo '$var está "setado" apesar de vazio';
}
?>
Notas
Nota: Este é um construtor de linguagem e não uma função, por isso não é possível chamá-lo através de funções variáveis