CKTIS / PHP
SplQueue::enqueue — aggiungere un elemento in fondo alla coda
Aggiunge un valore in fondo a una `SplQueue`. Il metodo modifica direttamente la coda e non restituisce alcun risultato; l’estrazione segue l’ordine FIFO.
Versione: PHP 8.3
Sintassi
public function enqueue(mixed $value): voidIn PHP 8.3, SplQueue è una classe della SPL nel namespace globale. In questa versione, la SPL fa parte del nucleo di PHP e non può essere disattivata. new \SplQueue() indica quella classe anche all’interno di un altro namespace. SplQueue::enqueue è un metodo di istanza: $queue->enqueue($value) aggiunge un valore in fondo alla coda esistente. mixed accetta qualsiasi valore PHP, compreso null, mentre void indica che il metodo non restituisce né un risultato né un oggetto con cui concatenare altre chiamate.
enqueue() è un alias di SplDoublyLinkedList::push(). Per rispettare l’ordine FIFO (il primo a entrare è il primo a uscire), usalo insieme a dequeue(), che rimuove e restituisce l’elemento in testa alla coda. Non sostituire dequeue() con pop(): pop() rimuove l’elemento in fondo.
Chiamare dequeue() su una coda vuota genera una RuntimeException. Se la coda potrebbe essere vuota, controllala con isEmpty() prima di estrarre un elemento. Un null restituito può essere un valore memorizzato, non un segnale che la coda è vuota.
Esempi
<?php
$queue = new \SplQueue();
$queue->enqueue('A');
$queue->enqueue('B');
echo $queue->dequeue(), "\n";
$queue->enqueue('C');
while (!$queue->isEmpty()) {
echo $queue->dequeue(), "\n";
}
Risultato
A B C
Dopo l’estrazione di `A`, `B` è ancora in coda. `C` va dietro a `B`, quindi il ciclo stampa `B` prima di `C`.
Lezioni correlate
- PHP · Lezione 65 · Avanzato · Versione: 2