WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / PHP

SplQueue::enqueue — ein Element am Ende der Warteschlange anfügen

Fügt einen Wert am Ende einer `SplQueue` an. Die Methode ändert die Warteschlange direkt und liefert kein Ergebnis; die Entnahme folgt der FIFO-Reihenfolge.

Version: PHP 8.3

Syntax

public function enqueue(mixed $value): void

In PHP 8.3 gehört SplQueue zur SPL und liegt im globalen Namensraum. In dieser Version ist die SPL Teil des PHP-Kerns und lässt sich nicht deaktivieren. new \SplQueue() wählt diese Klasse auch innerhalb eines anderen Namensraums. SplQueue::enqueue ist eine Instanzmethode: $queue->enqueue($value) hängt einen Wert an das Ende der bestehenden Warteschlange an. mixed erlaubt jeden PHP-Wert, auch null. void bedeutet, dass die Methode weder ein Ergebnis noch ein Objekt zum Verketten von Aufrufen zurückgibt.

enqueue() ist ein Alias für SplDoublyLinkedList::push(). Für FIFO (zuerst hinein, zuerst hinaus) verwende dazu dequeue(): Es entfernt das vorderste Element und gibt es zurück. Ersetze dequeue() nicht durch pop(), denn pop() entfernt ein Element am Ende.

Ein Aufruf von dequeue() bei leerer Warteschlange löst eine RuntimeException aus. Wenn die Warteschlange leer sein könnte, prüfe vor der Entnahme isEmpty(). Ein zurückgegebenes null kann ein gespeicherter Wert sein und signalisiert keine leere Warteschlange.

Beispiele

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

echo $queue->dequeue(), "\n";
$queue->enqueue('C');

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

Ergebnis

A
B
C

Nach der Entnahme von `A` wartet `B` noch. `C` wird hinter `B` eingefügt, deshalb gibt die Schleife `B` vor `C` aus.

Zugehörige Lektionen

  • PHP · Lektion 65 · Fortgeschritten · Version: 2

Quellen