empty

(PHP 4, PHP 5, PHP 7)

empty — Informa se a variável é vazia

Descrição

bool empty ( mixed $var )

Determina se a variável é considerada vazia.

Parâmetros

var

Variável a ser verificada

Note:

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)

Changelog

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

Note: 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

Veja Também