Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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): int

Pole [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

Zdroje