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

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

Fuentes