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

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

Fontes