CKTIS / PHP
count: počet prvkov, nie posledný index
count vracia počet prvkov poľa alebo výsledok metódy objektu Countable. Nemeria reťazce a nepredpokladá súvislé indexy začínajúce nulou.
Verzia: PHP 8.4
Syntax
count(Countable|array $value, int $mode = COUNT_NORMAL): intPole [2 => "a", 8 => "b"] má dva prvky, preto count vráti 2, nie 9. Prázdne pole má 0 prvkov. Nahradenie hodnoty pod existujúcim kľúčom nepridá nový prvok.
Predvolený COUNT_NORMAL počíta iba najvyššiu úroveň poľa. COUNT_RECURSIVE pripočíta prvky vnorených polí a počíta aj pozície, ktoré tieto polia obsahujú. Nepočíta teda iba koncové hodnoty. Cyklické odkazy vyvolajú upozornenie.
V PHP 8.4 vyvolajú count(null) a bežný reťazec ako argument TypeError. Objekt musí implementovať Countable; samotná možnosť iterácie nestačí. Pri neistom vstupe over is_countable a osobitne urči význam chýbajúcich dát.
Príklad porovnáva bežné a rekurzívne počítanie a zachytí chybu typu. Nenahrádzaj každý neplatný vstup automaticky prázdnym poľom: mohol by si tak skryť chybu načítania dát namiesto vyjadrenia skutočne prázdnej kolekcie.
Prí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ýsledok
2 2 4 TypeError