empty

(PHP 4, PHP 5)

emptyD�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, toute 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

Version Description
PHP 5

Depuis PHP 5, les objets n'ayant pas de propri�t� 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 fonctions variables.

Note: Lors de l'utilisation de cette fonction sur des propri�t�s d'objet inaccessibles, la m�thode magique __isset sera appel�e, si elle existe.

Voir aussi