Manuel PHP

Fonctions sur les tableaux
PHP Manual

count

(PHP 4, PHP 5)

count — Compte le nombre d'éléments d'un tableau ou le nombre de propriétés d'un objet

Description

int count ( mixed $var [, int $mode ] )

Compte le nombre d'éléments d'un tableau ou le nombre de propriétés d'un objet.

Pour les objets, count() retourne le nombre de propriétés non-statiques, sans tenir compte de la visibilité. Si SPL est disponible, vous pouvez utiliser la fonction count() en implémentant l'interface Countable. Cette interface a exactement une méthode, count(), qui retourne la valeur retournée par la fonction count().

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

Liste de paramètres

var

Le tableau.

mode

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. count() ne détecte pas la récursivité infinie.

Valeurs de retour

Retourne le nombre d'éléments dans var , qui est généralement un tableau et tout le reste, sauf les objets, n'aura qu'un élément.

Si le paramètre var n'est ni un objet, ni un tableau, 1 sera retourné. Il y a néanmoins une exception : si le paramètre var vaut NULL, 0 sera retourné.

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.

Historique

Version Description
4.2.0 Le paramètre optionnel mode a été ajouté.

Exemples

Exemple #1 Exemple avec count()

  1. <?php
  2. $a[0] = 1;  
  3. $a[1] = 3;  
  4. $a[2] = 5;  
  5. $result = count($a);  
  6. // $result == 3
  7.  
  8. $b[0] = 7;  
  9. $b[5] = 9;  
  10. $b[10] = 11;  
  11. $result = count($b);  
  12. // $result == 3
  13.  
  14. $result = count(null);  
  15. // $result == 0
  16.  
  17. $result = count(false);  
  18. // $result == 1
  19. ?> 

Exemple #2 Exemple de récursivité avec count()

  1. <?php
  2. $food = array('fruits' => array('orange', 'banana', 'apple'), 
  3.          'veggie' => array('carrot', 'collard', 'pea'));  
  4.  
  5. // count récursif
  6. echo count($food, COUNT_RECURSIVE); // affiche 8
  7.  
  8. // count normal
  9. echo count($food); // affiche 2
  10.  
  11. ?> 

Voir aussi

Fonctions sur les tableaux
PHP Manual

Remonter Remonter
L'éditeur javascript - CSS - Gentoo - Tutoriaux PHP - Tutoriels PHP - Bretagne - php - Moto - Kit graphique