count() w PHP: długość i rozmiar tablicy

count($arr) zwraca liczbę elementów tablicy: count(['red', 'green', 'blue']) to 3. Tablice w PHP nie mają właściwości length, więc długość lub rozmiar tablicy pobierasz przez count().

<?php
$fruits = ['apple', 'banana', 'cherry'];
echo count($fruits), "\n";

$fruits[] = 'date';
echo count($fruits), "\n";

echo count([]), "\n";                          // empty array
echo count(['a' => 1, 'b' => 2]), "\n";        // keys of any kind

count() jest szybkie: PHP przechowuje rozmiar wewnątrz tablicy, więc policzenie miliona elementów kosztuje tyle samo co policzenie trzech.

Liczenie tablicy wielowymiarowej

Domyślnie count() liczy tylko najwyższy poziom. Podaj COUNT_RECURSIVE (albo 1) jako drugi argument, aby policzyć każdy element na każdej głębokości. Same zagnieżdżone tablice też są liczone, dlatego suma bywa większa niż liczba wartości w liściach.

<?php
$teams = [
    'red'  => ['Ada', 'Linus'],
    'blue' => ['Grace', 'Margaret', 'Alan'],
];

echo count($teams), "\n";                    // 2 teams
echo count($teams, COUNT_RECURSIVE), "\n";   // 2 teams + 5 names

// Only the leaf values
echo count($teams, COUNT_RECURSIVE) - count($teams), "\n";
echo array_sum(array_map('count', $teams)), "\n";

Oba skróty zakładają dokładnie dwa poziomy. Przy głębszym zagnieżdżeniu w tablicy wielowymiarowej policz liście przez array_walk_recursive(): $n = 0; array_walk_recursive($arr, function () use (&$n) { $n++; });.

count vs sizeof

sizeof() to alias count(): te same argumenty, ten sam wynik. Używaj count(). Używa go prawie cały kod i dokumentacja PHP, a sizeof sugeruje rozmiar w bajtach każdemu, kto zna C.

<?php
$items = [1, 2, 3, 4];

echo count($items), "\n";
echo sizeof($items), "\n";
echo sizeof($items) === count($items) ? "same\n" : "different\n";

Liczenie wartości spełniających warunek

count() nie ma argumentu z warunkiem. Najpierw przefiltruj, potem policz: array_filter() zostawia elementy, które akceptuje twój callback. Aby policzyć, ile razy pojawia się każda wartość, użyj array_count_values().

<?php
$scores = [45, 82, 67, 91, 38, 74];

$passed = count(array_filter($scores, fn($s) => $s >= 50));
echo "$passed of ", count($scores), " passed\n";

$answers = ['yes', 'no', 'yes', 'maybe', 'yes'];
$tally = array_count_values($answers);
print_r($tally);
echo $tally['yes'], "\n";

Liczenie znaków w stringu

count() służy do tablic. Dla stringa użyj strlen() dla bajtów albo mb_strlen() dla znaków; różnią się, gdy tylko tekst ma znaki diakrytyczne, polskie litery czy japoński. Różnicę opisuje strona o strlen. Aby policzyć słowa, najpierw podziel tekst.

<?php
$text = 'naïve café au lait';

echo strlen($text), "\n";             // bytes: ï and é take two each
echo mb_strlen($text), "\n";          // characters
echo str_word_count($text), "\n";     // words (ASCII letters only)
echo count(explode(' ', $text)), "\n"; // pieces split on spaces

str_word_count() traktuje litery spoza ASCII jako separatory, więc naïve liczy się jako dwa słowa. Dzielenie po spacjach jest bardziej przewidywalne dla prawdziwego tekstu.

count() na null lub stringu rzuca błąd

Od PHP 8 count() przyjmuje tylko tablice i obiekty implementujące Countable. Wszystko inne rzuca TypeError, podczas gdy PHP od 7.2 do 7.4 zwracało 0 (dla null) albo 1 (dla stringa lub liczby) z ostrzeżeniem. Zwykła przyczyna to zmienna, która czasem jest null, na przykład brakujący klucz albo funkcja, która nic nie zwróciła.

<?php
// This throws a TypeError on purpose
$tags = null;
echo count($tags);

Podstaw pustą tablicę przez ??, a wynik wyniesie 0:

<?php
$post = ['title' => 'Hello'];        // no 'tags' key

echo count($post['tags'] ?? []), "\n";

$tags = null;
echo count($tags ?? []), "\n";

echo is_countable($tags) ? count($tags) : 0, "\n";

Sprawdzanie, czy tablica jest pusta

Aby zapytać „czy w tej tablicy coś jest”, porównaj z pustą tablicą albo użyj empty(). count($arr) === 0 też działa, ale tylko gdy $arr na pewno jest tablicą.

<?php
$cart = [];

if ($cart === []) {
    echo "Your cart is empty\n";
}

var_dump(empty($cart));
var_dump(count($cart) > 0);

$cart[] = 'book';
var_dump(empty($cart));

empty($x) nigdy nie rzuca błędu, nawet gdy $x jest niezdefiniowane albo null, dlatego to bezpieczniejsze sprawdzenie dla wartości, która może nie być tablicą. Pozostałe zasady (pusty string i "0" też są puste) opisuje strona o empty.