CKTIS / PHP
SplQueue::dequeue — haal het voorste element uit de wachtrij
`dequeue()` verwijdert het voorste element uit een FIFO-wachtrij en geeft de waarde terug. Een lege wachtrij leidt tot `RuntimeException`; `null` kan een opgeslagen waarde zijn.
Versie: PHP 8.3
Syntax
public function dequeue(): mixed
$value = $queue->dequeue();In PHP 8.3 is SplQueue::dequeue een openbare instantiemethode van de SPL-klasse \SplQueue. SPL is ingebouwd in PHP 8.3 en kan niet worden uitgeschakeld. De aanroep $queue->dequeue() krijgt geen argumenten: hij verwijdert één element vooraan in de wachtrij en geeft de waarde terug als mixed. Omdat enqueue() elementen achteraan toevoegt, komen ze in dezelfde volgorde uit de wachtrij als waarin ze zijn toegevoegd (FIFO).
De methode is een alias van SplDoublyLinkedList::shift(). Gebruik de overgeërfde methode bottom() om het voorste element te lezen zonder het te verwijderen. pop() verwijdert juist het element aan de andere kant en geeft de waarde daarvan terug.
Een aanroep van dequeue() op een lege wachtrij gooit een \RuntimeException. Als een lege wachtrij te verwachten is, controleer dan met isEmpty() of de wachtrij leeg is voordat je een element verwijdert. Een resultaat van null of false kan een opgeslagen waarde zijn en geeft niet aan dat de wachtrij leeg is.
Voorbeelden
<?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";
}
Resultaat
'A' NULL 'B' RuntimeException
De lus toont alle drie de waarden in de volgorde waarin ze zijn toegevoegd, inclusief `NULL`. De laatste aanroep slaat de controle met `isEmpty()` bewust over en toont de klassenaam van de opgevangen uitzondering.
Gerelateerde lessen
- PHP · Les 65 · Gevorderd · Versie: 2