CKTIS / PHP
SplQueue::isEmpty — Comprobar si una cola está vacía
`isEmpty()` comprueba si una `SplQueue` tiene cero elementos. Úsalo antes de `dequeue()` para distinguir una cola vacía de otra que contiene `null` o `false`.
Versión: PHP 8.3
Sintaxis
public function isEmpty(): bool
$queue->isEmpty()SplQueue::isEmpty es un método público de instancia heredado de SplDoublyLinkedList. Llámalo sin argumentos como $queue->isEmpty(), no de forma estática. Devuelve un bool: true si la cola no tiene elementos y false si tiene al menos uno. No elimina elementos ni hace avanzar el iterador.
La comprobación se refiere al estado actual de la cola, no a los valores que contiene: null, false y 0 cuentan como elementos. $queue->count() === 0 responde a la misma pregunta, pero isEmpty() expresa la intención directamente. La construcción del lenguaje empty($queue) no comprueba cuántos elementos contiene el objeto SplQueue.
enqueue() añade un elemento al final, mientras que dequeue() retira y devuelve el que está al principio (FIFO: el primero en entrar es el primero en salir). Llamar a dequeue() sobre una cola vacía lanza RuntimeException. Para vaciar la cola, comprueba !$queue->isEmpty() antes de cada extracción. El ejemplo está pensado para PHP 8.3, donde SPL está integrada y no se puede desactivar. \SplQueue se refiere a la clase del espacio de nombres global.
Ejemplos
<?php
$queue = new \SplQueue();
var_dump($queue->isEmpty());
$queue->enqueue(null);
$queue->enqueue(false);
var_dump($queue->isEmpty());
while (!$queue->isEmpty()) {
var_dump($queue->dequeue());
}
var_dump($queue->isEmpty());
Resultado
bool(true) bool(false) NULL bool(false) bool(true)
La cola recién creada da `true` y, tras dos inserciones, da `false`. El bucle muestra `NULL` y luego `bool(false)`. Son los valores extraídos; el último `bool(true)` indica que la cola vuelve a estar vacía.
Lecciones relacionadas
- PHP · Lección 65 · Avanzado · Versión: 2