Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / PHP

SplQueue::isEmpty — Verificare se una coda è vuota

`isEmpty()` verifica se una `SplQueue` contiene zero elementi. Usalo prima di `dequeue()` per distinguere una coda vuota da una che contiene `null` o `false`.

Versione: PHP 8.3

Sintassi

public function isEmpty(): bool
$queue->isEmpty()

SplQueue::isEmpty è un metodo pubblico di istanza ereditato da SplDoublyLinkedList. Chiamalo senza argomenti come $queue->isEmpty(), non in modo statico. Restituisce un bool: true se la coda non contiene elementi e false se ne contiene almeno uno. Non rimuove elementi e non fa avanzare l'iteratore.

Il controllo riguarda lo stato attuale della coda, non i valori che contiene: null, false e 0 contano come elementi. $queue->count() === 0 risponde alla stessa domanda, ma isEmpty() esprime direttamente l'intento. Il costrutto del linguaggio empty($queue) non controlla quanti elementi contiene l'oggetto SplQueue.

enqueue() aggiunge un elemento in fondo alla coda, mentre dequeue() rimuove e restituisce quello in testa (FIFO: il primo a entrare è il primo a uscire). Su una coda vuota, dequeue() lancia una RuntimeException. Per svuotare la coda, verifica !$queue->isEmpty() prima di ogni estrazione. L'esempio è per PHP 8.3, in cui SPL è integrata e non può essere disattivata. \SplQueue indica la classe nello spazio dei nomi globale.

Esempi

<?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());

Risultato

bool(true)
bool(false)
NULL
bool(false)
bool(true)

La nuova coda restituisce `true`; dopo due inserimenti restituisce `false`. Il ciclo stampa `NULL` e poi `bool(false)`. Sono i valori estratti; l'ultimo `bool(true)` indica che la coda è di nuovo vuota.

Lezioni correlate

  • PHP · Lezione 65 · Avanzato · Versione: 2

Fonti