PHP count(): lunghezza e numero di elementi di un array

count($arr) restituisce il numero di elementi di un array: count(['red', 'green', 'blue']) vale 3. Gli array PHP non hanno una proprietà length, quindi count() è il modo per ottenere la lunghezza o la dimensione di un array.

<?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() è veloce: PHP memorizza la dimensione dentro l'array, quindi contare un milione di elementi costa quanto contarne tre.

Contare un array multidimensionale

Di default count() conta solo il primo livello. Passa COUNT_RECURSIVE (o 1) come secondo argomento per contare ogni elemento a ogni profondità. Vengono contati anche gli array annidati stessi, ed è per questo che il totale è spesso maggiore del numero di valori finali.

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

Entrambe le scorciatoie presuppongono esattamente due livelli. Per un annidamento più profondo in un array multidimensionale, conta i valori finali con array_walk_recursive(): $n = 0; array_walk_recursive($arr, function () use (&$n) { $n++; });.

count vs sizeof

sizeof() è un alias di count(): stessi argomenti, stesso risultato. Usa count(). È quello che usano quasi tutto il codice e la documentazione PHP, e sizeof fa pensare a una dimensione in byte a chiunque conosca il C.

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

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

Contare i valori che soddisfano una condizione

count() non ha un argomento per la condizione. Prima filtra, poi conta: array_filter() tiene gli elementi che la tua callback accetta. Per contare quante volte compare ogni valore, usa 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";

Contare i caratteri di una stringa

count() è per gli array. Per una stringa, usa strlen() per i byte o mb_strlen() per i caratteri; differiscono appena il testo contiene accenti o giapponese. La pagina su strlen spiega la differenza. Per contare le parole, prima dividi la stringa.

<?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() tratta le lettere non ASCII come separatori, quindi naïve conta come due parole. Dividere sugli spazi è più prevedibile per il testo reale.

count() su null o su una stringa lancia un errore

Da PHP 8, count() accetta solo array e oggetti che implementano Countable. Qualsiasi altra cosa lancia un TypeError, mentre PHP da 7.2 a 7.4 restituiva 0 (per null) o 1 (per una stringa o un numero) con un warning. La causa abituale è una variabile che a volte è null, come una chiave mancante o una funzione che non ha restituito nulla.

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

Imposta come default un array vuoto con ??, e il conteggio sarà 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";

Verificare se un array è vuoto

Per chiedere "questo array contiene qualcosa", confronta con un array vuoto oppure usa empty(). Funziona anche count($arr) === 0, ma solo quando $arr è certamente un array.

<?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) non lancia mai errori, anche quando $x non è definita o è null, il che lo rende il controllo più sicuro per un valore che potrebbe non essere un array. Le sue altre regole (anche una stringa vuota e "0" sono vuoti) sono nella pagina su empty.