(PHP 4, PHP 5, PHP 7, PHP 8)
count — Compte tous les éléments d'un tableau ou dans un objet Countable
Compte tous les éléments dans un tableau quand utilisé avec un tableau. Quand utilisé avec un objet qui implémente l'interface Countable, ceci retourne la valeur de la méthode Countable::count().
valueUn tableau ou un objet Countable.
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 fonction count() peut détecter les récursions afin d'éviter les boucles infinies, mais émettra une alerte de type E_WARNING à chaque fois qu'une boucle infinie surviendra (dans le cas où un tableau contient lui-même plus d'une boucle infinie) et retournera un compteur plus grand que l'attendu.
Retourne le nombre d'éléments dans value. Antérieur à PHP 8.0.0, si le paramètre n'est ni un tableau, ni un objet qui implémente l'interface Countable, 1 était retourné, sauf si value était null, au quel cas 0 était retourné.
| Version | Description |
|---|---|
| 8.0.0 | count() lance désormais une TypeError pour des types dénombrables invalides passés au paramètre value. |
| 7.2.0 | count() génère désormais un avertissement pour des types dénombrables invalides passés au paramètre value. |
Exemple #1 Exemple avec count()
<?php
$a[0] = 1;
$a[1] = 3;
$a[2] = 5;
var_dump(count($a));
$b[0] = 7;
$b[5] = 9;
$b[10] = 11;
var_dump(count($b));
?>L'exemple ci-dessus va afficher :
int(3) int(3)
Exemple #2 Exemple de count() avec un argument non Countable|array (contre-exemple - ne pas faire ceci)
<?php
$b[0] = 7;
$b[5] = 9;
$b[10] = 11;
var_dump(count($b));
var_dump(count(null));
var_dump(count(false));
?>L'exemple ci-dessus va afficher :
int(3) int(0) int(1)
Résultat de l'exemple ci-dessus en PHP 7.2:
int(3) Warning: count(): Parameter must be an array or an object that implements Countable in … on line 12 int(0) Warning: count(): Parameter must be an array or an object that implements Countable in … on line 14 int(1)
Résultat de l'exemple ci-dessus en PHP 8 :
int(3) Fatal error: Uncaught TypeError: count(): Argument #1 ($var) must be of type Countable .. on line 12
Exemple #3 Exemple de récursivité avec count()
<?php
$food = array('fruits' => array('orange', 'banana', 'apple'),
'veggie' => array('carrot', 'collard', 'pea'));
// count récursif
var_dump(count($food, COUNT_RECURSIVE));
// count normal
var_dump(count($food));
?>L'exemple ci-dessus va afficher :
int(8) int(2)
Exemple #4 Objet Countable
<?php
class CountOfMethods implements Countable
{
private function someMethod()
{
}
public function count(): int
{
return count(get_class_methods($this));
}
}
$obj = new CountOfMethods();
var_dump(count($obj));
?>L'exemple ci-dessus va afficher :
int(2)