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

CKTIS / PHP

SplQueue::enqueue — añadir un elemento al final de la cola

Añade un valor al final de una `SplQueue`. El método modifica la cola directamente y no devuelve ningún resultado; la extracción sigue el orden FIFO.

Versión: PHP 8.3

Sintaxis

public function enqueue(mixed $value): void

En PHP 8.3, SplQueue es una clase de SPL que está en el espacio de nombres global. En esta versión, SPL forma parte del núcleo de PHP y no se puede desactivar. new \SplQueue() selecciona esa clase incluso desde otro espacio de nombres. SplQueue::enqueue es un método de instancia: $queue->enqueue($value) añade un valor al final de la cola existente. mixed admite cualquier valor de PHP, incluido null, y void indica que el método no devuelve ningún resultado ni un objeto para encadenar llamadas.

enqueue() es un alias de SplDoublyLinkedList::push(). Para mantener el orden FIFO (primero en entrar, primero en salir), combínalo con dequeue(), que extrae y devuelve el elemento del principio de la cola. No sustituyas dequeue() por pop(): pop() extrae del final.

Llamar a dequeue() con la cola vacía lanza una RuntimeException. Si la cola podría estar vacía, compruébalo con isEmpty() antes de extraer un elemento. Un null devuelto 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('B');

echo $queue->dequeue(), "\n";
$queue->enqueue('C');

while (!$queue->isEmpty()) {
    echo $queue->dequeue(), "\n";
}

Resultado

A
B
C

Después de extraer `A`, `B` sigue en la cola. `C` se añade detrás de `B`, así que el bucle imprime `B` antes que `C`.

Lecciones relacionadas

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

Fuentes