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): intTablica [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