Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / PHP

count: número de elementos, não o último índice

count devolve o número de elementos de um array ou o resultado de um método de um objeto Countable. Não mede cadeias nem pressupõe índices consecutivos a partir de zero.

Versão: PHP 8.4

Sintaxe

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

O array [2 => "a", 8 => "b"] tem dois elementos, pelo que count dá 2, não 9. Um array vazio tem 0 elementos. Substituir um valor numa chave existente não acrescenta um elemento.

O modo predefinido COUNT_NORMAL conta apenas o nível superior do array. COUNT_RECURSIVE soma os elementos de arrays aninhados e conta também as posições que contêm esses arrays. Não conta, portanto, apenas os valores finais. As referências cíclicas geram um aviso.

Em PHP 8.4, count(null) e uma cadeia comum como argumento provocam TypeError. Um objeto tem de implementar Countable; ser apenas iterável não basta. Perante entradas incertas, verifica is_countable e define separadamente o significado da ausência de dados.

O exemplo compara a contagem normal com a recursiva e captura um erro de tipo. Não substituas automaticamente todas as entradas inválidas por um array vazio: poderias esconder uma falha na obtenção dos dados em vez de representar uma coleção realmente vazia.

Exemplos

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

Resultado

2
2 4
TypeError

Fontes