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

CKTIS / PHP

SplQueue::count — Contar los elementos de una cola

Usa `SplQueue::count` para saber cuántos elementos hay en una cola FIFO sin retirar ninguno. Si la cola está vacía, el resultado es `0`.

Versión: PHP 8.3

Sintaxis

public function count(): int // The inherited return type is tentative in PHP 8.3.

$queue->count();
\count($queue);

SplQueue::count es un método público de instancia heredado de SplDoublyLinkedList::count. Llámalo con $queue->count(): el :: del nombre del símbolo no indica una llamada estática. El método no recibe argumentos y devuelve el número actual de elementos como int, incluido 0 si la cola está vacía.

Contar no recorre la cola, no desplaza su iterador ni retira elementos, ni siquiera en el modo IT_MODE_DELETE. Cada valor añadido cuenta como un elemento, aunque sea un array. Como SplQueue implementa Countable a través de su clase base, la función global \count($queue) devuelve el mismo resultado. El método no admite un modo de recuento.

En una cola FIFO, enqueue() añade un elemento al final y dequeue() retira y devuelve el primero. El resultado de count() describe la cola en el momento de la llamada. Si solo necesitas saber si la cola está vacía, usa $queue->isEmpty(). A diferencia del recuento, dequeue() lanza una RuntimeException si la cola está vacía.

El ejemplo está pensado para PHP 8.3. La clase \SplQueue forma parte de SPL, que siempre está habilitada en las compilaciones estándar de PHP 8.3.

Ejemplos

<?php
$queue = new \SplQueue();
echo $queue->count(), "\n";

$queue->enqueue('A');
$queue->enqueue(['B', 'C']);
echo $queue->count(), "\n";
echo \count($queue), "\n";

echo $queue->dequeue(), "\n";
echo $queue->count(), "\n";

Resultado

0
2
2
A
1

El primer resultado es `0`. Tras añadir dos valores, ambas formas de contar devuelven `2`: `['B', 'C']` es un único elemento de la cola. `dequeue()` devuelve `A`, por lo que queda `1` elemento.

Lecciones relacionadas

  • PHP · Lección 65 · Avanzado · Versión: 2

Fuentes