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): voidEm 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