Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / PHP

SplQueue::dequeue — estrarre il primo elemento dalla coda

`dequeue()` rimuove il primo elemento di una coda FIFO e ne restituisce il valore. Se la coda è vuota, lancia `RuntimeException`; `null` può invece essere un valore memorizzato.

Versione: PHP 8.3

Sintassi

public function dequeue(): mixed

$value = $queue->dequeue();

In PHP 8.3, SplQueue::dequeue è un metodo pubblico di istanza della classe \SplQueue di SPL. SPL è integrata in PHP 8.3 e non può essere disattivata. La chiamata $queue->dequeue() non accetta argomenti: rimuove un elemento dalla testa della coda e ne restituisce il valore come mixed. Poiché enqueue() aggiunge gli elementi in fondo, questi escono nell’ordine di inserimento (FIFO).

Il metodo è un alias di SplDoublyLinkedList::shift(). Per leggere il primo elemento senza rimuoverlo, usa il metodo ereditato bottom(). Invece, pop() rimuove l’elemento all’estremità opposta e ne restituisce il valore.

Chiamare dequeue() su una coda vuota lancia una \RuntimeException. Se è normale che la coda sia vuota, controllane lo stato con isEmpty() prima di estrarre un elemento. Un valore restituito pari a null o false può essere un dato memorizzato, non un segnale che la coda sia vuota.

Esempi

<?php
$queue = new \SplQueue();
$queue->enqueue('A');
$queue->enqueue(null);
$queue->enqueue('B');

while (!$queue->isEmpty()) {
    echo var_export($queue->dequeue(), true), "\n";
}

try {
    $queue->dequeue();
} catch (\RuntimeException $exception) {
    echo get_class($exception), "\n";
}

Risultato

'A'
NULL
'B'
RuntimeException

Il ciclo stampa tutti e tre i valori nell’ordine di inserimento, compreso `NULL`. L’ultima chiamata salta di proposito il controllo con `isEmpty()` e stampa il nome della classe dell’eccezione intercettata.

Lezioni correlate

  • PHP · Lezione 65 · Avanzato · Versione: 2

Fonti