Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / PHP

count: liczba elementów, nie ostatni indeks

count zwraca liczbę elementów tablicy albo wynik metody obiektu Countable. Nie oblicza długości napisu i nie zakłada kolejnych indeksów od zera.

Wersja: PHP 8.4

Składnia

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

Tablica [2 => "a", 8 => "b"] ma dwa elementy, więc count daje 2, a nie 9. Pusta tablica ma 0 elementów. Nadpisanie wartości pod istniejącym kluczem nie dodaje nowego elementu.

Domyślny COUNT_NORMAL liczy tylko najwyższy poziom tablicy. COUNT_RECURSIVE dodaje elementy tablic zagnieżdżonych i liczy też same pozycje zawierające te tablice. Nie jest zatem licznikiem wyłącznie końcowych wartości. Cykliczne odwołania powodują ostrzeżenie.

W PHP 8.4 count(null) oraz przekazanie zwykłego napisu powodują TypeError. Obiekt musi implementować Countable; samo to, że da się po nim iterować, nie wystarcza. Przy niepewnym wejściu sprawdź is_countable i osobno ustal, co oznacza brak danych.

Przykład porównuje zwykłe i rekurencyjne liczenie oraz przechwytuje błąd typu. Nie zamieniaj każdego nieprawidłowego wejścia automatycznie na pustą tablicę: mogłoby to ukryć błąd pobierania danych zamiast rzeczywistego braku elementów.

Przykłady

<?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";
}

Wynik

2
2 4
TypeError

Źródła