WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

Quellen