Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / PHP

count : le nombre d'éléments, pas le dernier indice

count renvoie le nombre d'éléments d'un tableau ou le résultat d'une méthode d'objet Countable. Il ne mesure pas les chaînes et ne suppose pas des indices consécutifs depuis zéro.

Version : PHP 8.4

Syntaxe

count(Countable|array $value, int $mode = COUNT_NORMAL): int

Le tableau [2 => "a", 8 => "b"] contient deux éléments : count donne donc 2, pas 9. Un tableau vide contient 0 élément. Remplacer la valeur d'une clé existante n'ajoute aucun élément.

Le mode par défaut COUNT_NORMAL compte seulement le premier niveau du tableau. COUNT_RECURSIVE ajoute les éléments des tableaux imbriqués et compte aussi les positions qui contiennent ces tableaux. Il ne compte donc pas uniquement les valeurs terminales. Les références cycliques produisent un avertissement.

En PHP 8.4, count(null) et une chaîne ordinaire comme argument provoquent TypeError. Un objet doit implémenter Countable ; être simplement itérable ne suffit pas. Pour une entrée incertaine, utilise is_countable et détermine séparément le sens de l'absence de données.

L'exemple compare le comptage normal et récursif et intercepte une erreur de type. Ne remplace pas automatiquement chaque entrée incorrecte par un tableau vide : cela pourrait masquer un échec de récupération des données au lieu de représenter une collection réellement vide.

Exemples

<?php
declare(strict_types=1);

echo count([2 => "a", 8 => "b"]), "\n";
$groups = [[1, 2], []];
echo count($groups), " ", count($groups, COUNT_RECURSIVE), "\n";
try {
    count(null);
} catch (TypeError $error) {
    echo "TypeError\n";
}

Résultat

2
2 4
TypeError

Sources