CKTIS / PHP
count: Elementanzahl statt letzter Index
count liefert die Anzahl der Array-Elemente oder das Ergebnis einer Countable-Objektmethode. Es misst keine Zeichenketten und setzt keine fortlaufenden Indizes ab null voraus.
Version: PHP 8.4
Syntax
count(Countable|array $value, int $mode = COUNT_NORMAL): intDas Array [2 => "a", 8 => "b"] hat zwei Elemente, daher ergibt count 2 statt 9. Ein leeres Array hat 0 Elemente. Das Ersetzen eines Werts unter einem vorhandenen Schlüssel fügt kein Element hinzu.
Der Standardmodus COUNT_NORMAL zählt nur die oberste Array-Ebene. COUNT_RECURSIVE zählt Elemente verschachtelter Arrays hinzu und berücksichtigt auch die Positionen, die diese Arrays enthalten. Es zählt also nicht nur die Endwerte. Zyklische Referenzen erzeugen eine Warnung.
In PHP 8.4 führen count(null) und eine gewöhnliche Zeichenkette als Argument zu TypeError. Ein Objekt muss Countable implementieren; bloße Iterierbarkeit genügt nicht. Prüfe unsichere Eingaben mit is_countable und entscheide getrennt, was fehlende Daten bedeuten.
Das Beispiel vergleicht normales und rekursives Zählen und fängt einen Typfehler ab. Ersetze nicht jede ungültige Eingabe automatisch durch ein leeres Array: Das könnte einen Fehler beim Datenabruf verbergen, statt eine tatsächlich leere Sammlung darzustellen.
Beispiele
<?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";
}
Ergebnis
2 2 4 TypeError