CKTIS / PHP
SplQueue::isEmpty — Verificar se uma fila está vazia
`isEmpty()` verifica se uma `SplQueue` não contém elementos. Usa este método antes de `dequeue()` para distinguir uma fila vazia de uma que contém `null` ou `false`.
Versão: PHP 8.3
Sintaxe
public function isEmpty(): bool
$queue->isEmpty()SplQueue::isEmpty é um método público de instância herdado de SplDoublyLinkedList. Chama-o sem argumentos com $queue->isEmpty(), e não de forma estática. Devolve um bool: true se a fila não tiver elementos e false se tiver pelo menos um. Não remove elementos nem avança o iterador.
A verificação diz respeito ao estado atual da fila, não aos valores que contém: null, false e 0 contam como elementos. $queue->count() === 0 responde à mesma pergunta, mas isEmpty() exprime diretamente a intenção. A construção da linguagem empty($queue) não verifica quantos elementos estão no objeto SplQueue.
enqueue() acrescenta um elemento ao fim da fila e dequeue() remove e devolve o elemento da frente (FIFO: o primeiro a entrar é o primeiro a sair). Chamar dequeue() numa fila vazia lança uma RuntimeException. Para esvaziar a fila, verifica !$queue->isEmpty() antes de cada remoção. O exemplo destina-se ao PHP 8.3, em que a SPL está integrada e não pode ser desativada. \SplQueue identifica a classe no espaço de nomes global.
Exemplos
<?php
$queue = new \SplQueue();
var_dump($queue->isEmpty());
$queue->enqueue(null);
$queue->enqueue(false);
var_dump($queue->isEmpty());
while (!$queue->isEmpty()) {
var_dump($queue->dequeue());
}
var_dump($queue->isEmpty());
Resultado
bool(true) bool(false) NULL bool(false) bool(true)
A fila acabada de criar devolve `true` e, após duas inserções, devolve `false`. O ciclo apresenta `NULL` e depois `bool(false)`. São os valores retirados; o último `bool(true)` indica que a fila está novamente vazia.
Lições relacionadas
- PHP · Lição 65 · Avançado · Versão: 2