WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / PHP

SplQueue::dequeue — erstes Element entnehmen

`dequeue()` entfernt das erste Element aus einer FIFO-Warteschlange und gibt seinen Wert zurück. Bei einer leeren Warteschlange wird `RuntimeException` ausgelöst; `null` kann dagegen ein gespeicherter Wert sein.

Version: PHP 8.3

Syntax

public function dequeue(): mixed

$value = $queue->dequeue();

In PHP 8.3 ist SplQueue::dequeue eine öffentliche Instanzmethode der SPL-Klasse \SplQueue. SPL ist fest in PHP 8.3 integriert und kann nicht deaktiviert werden. Der Aufruf $queue->dequeue() erwartet keine Argumente, entfernt ein Element am Anfang der Warteschlange und gibt dessen Wert als mixed zurück. Da enqueue() Elemente hinten anfügt, werden sie in der Einfügereihenfolge entnommen (FIFO).

Die Methode ist ein Alias für SplDoublyLinkedList::shift(). Mit der geerbten Methode bottom() kannst du das erste Element lesen, ohne es zu entfernen. pop() hingegen entfernt das Element am anderen Ende und gibt dessen Wert zurück.

Ein Aufruf von dequeue() bei leerer Warteschlange löst eine \RuntimeException aus. Wenn eine leere Warteschlange zu erwarten ist, prüfe vor der Entnahme mit isEmpty(), ob sie leer ist. Ein zurückgegebenes null oder false kann ein gespeicherter Wert sein und zeigt nicht an, dass die Warteschlange leer ist.

Beispiele

<?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";
}

Ergebnis

'A'
NULL
'B'
RuntimeException

Die Schleife gibt alle drei Werte in der Einfügereihenfolge aus, einschließlich `NULL`. Der letzte Aufruf überspringt die Prüfung mit `isEmpty()` absichtlich und gibt den Klassennamen der abgefangenen Ausnahme aus.

Zugehörige Lektionen

  • PHP · Lektion 65 · Fortgeschritten · Version: 2

Quellen