CKTIS / PHP
SplQueue::dequeue — extraer el primer elemento de la cola
`dequeue()` quita el primer elemento de una cola FIFO y devuelve su valor. Si la cola está vacía, lanza `RuntimeException`; `null` sí puede ser un valor almacenado.
Versión: PHP 8.3
Sintaxis
public function dequeue(): mixed
$value = $queue->dequeue();En PHP 8.3, SplQueue::dequeue es un método de instancia público de la clase \SplQueue de SPL. SPL forma parte del núcleo de PHP 8.3 y no se puede desactivar. La llamada $queue->dequeue() no recibe argumentos: quita un elemento del principio de la cola y devuelve su valor como mixed. Como enqueue() añade los elementos al final, salen en orden de inserción (FIFO).
El método es un alias de SplDoublyLinkedList::shift(). Para consultar el primer elemento sin quitarlo, usa el método heredado bottom(). En cambio, pop() quita el elemento del extremo opuesto y devuelve su valor.
Llamar a dequeue() en una cola vacía lanza una \RuntimeException. Si es normal que la cola esté vacía, comprueba su estado con isEmpty() antes de extraer un elemento. Un resultado null o false puede ser un valor almacenado, no una señal de que la cola esté vacía.
Ejemplos
<?php
$queue = new \SplQueue();
$queue->enqueue('A');
$queue->enqueue(null);
$queue->enqueue('B');
while (!$queue->isEmpty()) {
echo var_export($queue->dequeue(), true), "\n";
}
try {
$queue->dequeue();
} catch (\RuntimeException $exception) {
echo get_class($exception), "\n";
}
Resultado
'A' NULL 'B' RuntimeException
El bucle imprime los tres valores en orden de inserción, incluido `NULL`. La última llamada omite a propósito la comprobación con `isEmpty()` e imprime el nombre de la clase de la excepción capturada.
Lecciones relacionadas
- PHP · Lección 65 · Avanzado · Versión: 2