CKTIS / PHP
count: počet prvků, ne poslední index
count vrací počet prvků pole nebo výsledek metody objektu Countable. Neměří řetězce a nepředpokládá souvislé indexy začínající nulou.
Verze: PHP 8.4
Syntaxe
count(Countable|array $value, int $mode = COUNT_NORMAL): intPole [2 => "a", 8 => "b"] obsahuje dva prvky, proto count vrací 2, nikoli 9. Prázdné pole má 0 prvků. Nahrazení hodnoty pod existujícím klíčem nepřidává nový prvek.
Výchozí COUNT_NORMAL počítá jen nejvyšší úroveň pole. COUNT_RECURSIVE přičítá prvky vnořených polí a počítá také pozice, které tato pole obsahují. Nepočítá tedy pouze koncové hodnoty. Cyklické odkazy způsobují varování.
V PHP 8.4 vyvolají count(null) a běžný řetězec jako argument TypeError. Objekt musí implementovat Countable; pouhá možnost iterace nestačí. U nejistého vstupu ověř is_countable a samostatně urči význam chybějících dat.
Příklad porovnává běžné a rekurzivní počítání a zachytí chybu typu. Nenahrazuj každý neplatný vstup automaticky prázdným polem: mohl bys tak skrýt chybu načtení dat místo vyjádření skutečně prázdné kolekce.
Příklady
<?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";
}
Výsledek
2 2 4 TypeError