CKTIS / PHP
SplQueue::isEmpty — Prüfen, ob eine Warteschlange leer ist
`isEmpty()` prüft, ob eine `SplQueue` keine Elemente enthält. Verwende die Methode vor `dequeue()`, um eine leere Warteschlange von einer mit `null` oder `false` zu unterscheiden.
Version: PHP 8.3
Syntax
public function isEmpty(): bool
$queue->isEmpty()SplQueue::isEmpty ist eine öffentliche Instanzmethode, die von SplDoublyLinkedList geerbt wird. Rufe sie ohne Argumente als $queue->isEmpty() auf, nicht statisch. Sie gibt einen bool zurück: true bei einer leeren Warteschlange und false, sobald mindestens ein Element vorhanden ist. Sie entfernt keine Elemente und bewegt den Iterator nicht weiter.
Die Prüfung betrifft den aktuellen Zustand der Warteschlange, nicht die Werte darin: null, false und 0 zählen als Elemente. $queue->count() === 0 beantwortet dieselbe Frage, aber isEmpty() drückt die Absicht direkt aus. Das Sprachkonstrukt empty($queue) prüft nicht, wie viele Elemente das SplQueue-Objekt enthält.
enqueue() fügt hinten ein Element hinzu; dequeue() entfernt das vorderste Element und gibt es zurück (FIFO: zuerst hinein, zuerst hinaus). Bei einer leeren Warteschlange löst dequeue() eine RuntimeException aus. Prüfe beim Leeren vor jeder Entnahme !$queue->isEmpty(). Das Beispiel ist für PHP 8.3 gedacht. SPL ist dort fest eingebaut und lässt sich nicht deaktivieren. \SplQueue bezeichnet die Klasse im globalen Namensraum.
Beispiele
<?php
$queue = new \SplQueue();
var_dump($queue->isEmpty());
$queue->enqueue(null);
$queue->enqueue(false);
var_dump($queue->isEmpty());
while (!$queue->isEmpty()) {
var_dump($queue->dequeue());
}
var_dump($queue->isEmpty());
Ergebnis
bool(true) bool(false) NULL bool(false) bool(true)
Die neue Warteschlange meldet `true`, nach zwei Einfügungen `false`. Die Schleife gibt zuerst `NULL`, dann `bool(false)` aus. Das sind die entnommenen Werte; das letzte `bool(true)` zeigt, dass die Warteschlange wieder leer ist.
Zugehörige Lektionen
- PHP · Lektion 65 · Fortgeschritten · Version: 2