count

(PHP 3, PHP 4 , PHP 5)

count -- Compte le nombre d'éléments d'un tableau

Description

int count ( mixed var [, int mode])

count() retourne le nombre d'éléments dans var, qui est généralement un tableau (et tout le reste n'aura qu'un élément).

Si var n'est pas un tableau, 1 sera retourné (exception : count(NULL) égale 0).

Note : Le paramètre optionnel mode est disponible depuis PHP 4.2.0.

Si le paramètre optionnel mode vaut COUNT_RECURSIVE (ou 1), count() va compter récursivement les tableaux. C'est particulièrement pratique pour compter le nombre d'éléments d'un tableau. La valeur par défaut pour mode est 0.

Attention

count() peut retourner 0 pour une variable qui n'a pas été affectée, ou pour un tableau vide. Utilisez plutôt isset() pour tester si la variable existe.

Reportez vous à la section sur les Tableaux du manuel, pour plus de détails sur le fonctionnement des tableaux en PHP.

Exemple 1. Exemple avec count()

<?php
  $a
[0] = 1;
  
$a[1] = 3;
  
$a[2] = 5;
  
$result = count ($a);
// $result == 3

  
$b[0] = 7;
  
$b[5] = 9;
  
$b[10] = 11;
  
$result = count ($b);
// $result == 3;
?>

Exemple 2. Exemple récursif avec count() (PHP >= 4.2.0)

<?php
$food
= array( 'fruits'  => array('orange', 'banane', 'pommes'),
               
'legumes'  => array('carotte', 'chou','pois'));

// count récursif
echo count($food, COUNT_RECURSIVE); // affiche 8

// count normal
echo count($food);                  // affiche 2

?>

Note : sizeof() est un alias de count().

Voir aussi is_array(), isset() et strlen().