Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / PHP

count: numero di elementi, non ultimo indice

count restituisce il numero di elementi di un array o il risultato di un metodo di un oggetto Countable. Non misura stringhe e non presuppone indici consecutivi da zero.

Versione: PHP 8.4

Sintassi

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

L'array [2 => "a", 8 => "b"] ha due elementi, quindi count restituisce 2, non 9. Un array vuoto ha 0 elementi. Sostituire il valore di una chiave esistente non aggiunge un elemento.

La modalità predefinita COUNT_NORMAL conta solo il livello superiore dell'array. COUNT_RECURSIVE aggiunge gli elementi degli array annidati e conta anche le posizioni che li contengono. Non conta quindi soltanto i valori terminali. I riferimenti ciclici producono un avviso.

In PHP 8.4, count(null) e una normale stringa come argomento provocano TypeError. Un oggetto deve implementare Countable; essere semplicemente iterabile non basta. Con ingressi incerti, verifica is_countable e stabilisci separatamente cosa significhi l'assenza di dati.

L'esempio confronta il conteggio normale e ricorsivo e intercetta un errore di tipo. Non sostituire automaticamente ogni ingresso non valido con un array vuoto: potresti nascondere un errore nel recupero dei dati anziché rappresentare una raccolta davvero vuota.

Esempi

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

Risultato

2
2 4
TypeError

Fonti