Manuel PHP
PrécédentSuivant

empty

(PHP 3, PHP 4, PHP 5 )

empty -- Détermine si une variable contient une valeur non nulle

Description

bool empty ( mixed var )

Détermine si une variable contient une valeur non nulle.

Liste de paramètres

var

Variable à vérifier.

Note : empty() ne vérifie que les variables, tout autre chose retournera une erreur d'analyse. En d'autres termes, ce qui suit ne fonctionne pas : empty(trim($name)).

empty() est l'opposé de (boolean) var, excepté le fait qu'aucune alerte n'est générée lorsqu'une variable n'est pas définie.

Valeurs de retour

Retourne FALSE si var a une valeur non-vide et différente de zéro.

Ce qui suit est considéré comme étant vide :

"" (une chaîne vide)
0 (0 en tant qu'entier)
"0" (0 en tant que chaîne de caractères)
NULL
FALSE
array() (un tableau vide)
var $var; (une variable déclarée, mais sans valeur dans une classe)

Historique

VersionDescription
PHP 5

Depuis PHP 5, les objets n'ayant pas de propriétés ne sont plus considérés comme vide.

PHP 4

Depuis PHP 4, la chaîne de caractères "0" est considérée comme vide.

Exemples

Exemple 1. Une comparaison simple empty() / isset().

<?php
$var = 0;
                   
// Evalué à vrai car $var est vide
if (empty($var)) {
  echo '$var vaut soit 0, vide, ou pas définie du tout';
}
                   
// Evalué à vrai car $var est défini
if (isset($var)) {
  echo '$var est définie même si elle est vide';
}
?>

Notes

Note : Comme ceci est une structure du langage, et non pas une fonction, il n'est pas possible de l'appeler avec les variables fonctions.

Voir aussi

isset()
unset()
array_key_exists()
count()
strlen()
Les tables de comparaison des types

PrécédentSommaireSuivant
doublevalNiveau supérieurfloatval