Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / PHP

SplQueue::enqueue — acrescentar um elemento ao fim da fila

Acrescenta um valor ao fim de uma `SplQueue`. O método altera a própria fila e não devolve qualquer resultado; a remoção segue a ordem FIFO.

Versão: PHP 8.3

Sintaxe

public function enqueue(mixed $value): void

Em PHP 8.3, SplQueue é uma classe da SPL no espaço de nomes global. Nesta versão, a SPL faz parte do núcleo do PHP e não pode ser desativada. new \SplQueue() seleciona essa classe mesmo a partir de outro espaço de nomes. SplQueue::enqueue é um método de instância: $queue->enqueue($value) acrescenta um valor ao fim da fila existente. mixed aceita qualquer valor PHP, incluindo null, e void significa que o método não devolve um resultado nem um objeto para encadear chamadas.

enqueue() é um alias de SplDoublyLinkedList::push(). Para respeitar a ordem FIFO (primeiro a entrar, primeiro a sair), usa-o em conjunto com dequeue(), que remove e devolve o elemento do início da fila. Não substituas dequeue() por pop(): pop() remove do fim da fila.

Invocar dequeue() numa fila vazia lança uma RuntimeException. Se a fila puder estar vazia, verifica-a com isEmpty() antes de remover um elemento. Um null devolvido pode ser um valor guardado, não um sinal de que a fila está vazia.

Exemplos

<?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

Depois de retirar `A`, `B` continua na fila. `C` fica atrás de `B`, por isso o ciclo imprime `B` antes de `C`.

Lições relacionadas

  • PHP · Lição 65 · Avançado · Versão: 2

Fontes