Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / PHP

count: número de elementos, no último índice

count devuelve el número de elementos de un array o el resultado de un método de un objeto Countable. No mide cadenas ni presupone índices consecutivos desde cero.

Versión: PHP 8.4

Sintaxis

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

El array [2 => "a", 8 => "b"] tiene dos elementos, así que count da 2 y no 9. Un array vacío tiene 0 elementos. Sustituir un valor bajo una clave existente no añade un elemento.

El modo predeterminado COUNT_NORMAL cuenta solo el nivel superior. COUNT_RECURSIVE suma los elementos de arrays anidados y también cuenta las posiciones que contienen esos arrays. Por tanto, no cuenta únicamente los valores finales. Las referencias cíclicas producen una advertencia.

En PHP 8.4, count(null) y una cadena ordinaria como argumento provocan TypeError. Un objeto debe implementar Countable; ser iterable no basta. Si la entrada es incierta, comprueba is_countable y decide por separado qué significa que falten datos.

El ejemplo compara el recuento normal y el recursivo y captura un error de tipo. No sustituyas automáticamente toda entrada incorrecta por un array vacío: podrías ocultar un fallo al recuperar datos en vez de representar una colección realmente vacía.

Ejemplos

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

Fuentes