WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / PHP

SplStack::isEmpty — prüfen, ob ein Stapel leer ist

`isEmpty()` prüft, ob ein `SplStack` keine Elemente enthält. Auch ein Stapel mit dem einzigen Element `false` ist nicht leer.

Version: PHP 8.3

Syntax

public function isEmpty(): bool
$stack->isEmpty()

SplStack::isEmpty ist eine öffentliche Instanzmethode, die von SplDoublyLinkedList geerbt wird. Sie erwartet keine Argumente und liefert einen bool-Wert: true bei null Elementen, false bei mindestens einem Element. Rufe sie mit $stack->isEmpty() an einem Objekt auf, nicht statisch mit ::. Das Beispiel ist für PHP 8.3 gedacht. In dieser Version gehört SPL zum PHP-Kern und lässt sich nicht deaktivieren. \SplStack bezeichnet die Klasse im globalen Namensraum.

Die Methode entfernt keine Elemente und bewegt den Iterator nicht. Sie prüft den Inhalt des gesamten Stapels, nicht wie valid() die aktuelle Iteratorposition. Auch false, 0 und null zählen als Elemente. Das Sprachkonstrukt empty($stack) prüft nicht, ob der Stapel null Elemente enthält.

Prüfe vor pop() mit !$stack->isEmpty(), ob ein Element vorhanden ist. Bei einem leeren Stapel löst pop() eine RuntimeException aus. Ein zurückgegebenes false ist kein Zeichen für einen leeren Stapel: Es kann der Wert des entfernten Elements sein.

Beispiele

<?php

$stack = new \SplStack();
var_dump($stack->isEmpty());

$stack->push(false);
var_dump($stack->isEmpty());

if (!$stack->isEmpty()) {
    var_dump($stack->pop());
}

var_dump($stack->isEmpty());

Ergebnis

bool(true)
bool(false)
bool(false)
bool(true)

Die dritte Zeile, `bool(false)`, zeigt den entfernten Wert. Die zweite Zeile sieht genauso aus, bedeutet aber, dass der Stapel vor dem Entfernen nicht leer war.

Zugehörige Lektionen

  • PHP · Lektion 64 · Fortgeschritten · Version: 2

Quellen