WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / PHP

SplStack::pop — Oberstes Element vom Stapel entfernen

Die Methode entfernt das oberste Element vom Stapel und gibt seinen Wert zurück. Bei einem leeren Stapel löst sie eine `\RuntimeException` aus.

Version: PHP 8.3

Syntax

$value = $stack->pop(); // $stack is a \SplStack
// Inherited signature: public function SplDoublyLinkedList::pop(): mixed

SplStack::pop ist eine öffentliche Instanzmethode, die von SplDoublyLinkedList geerbt wird. Rufe $stack->pop() ohne Argumente auf einem \SplStack-Objekt der SPL auf. Die Methode entfernt den letzten Knoten der doppelt verketteten Liste, also das oberste Element des Stapels, und gibt den gespeicherten Wert als mixed zurück.

push() legt ein Element oben auf den Stapel. Wenn du nur push() und pop() verwendest, werden die Elemente in umgekehrter Einfügereihenfolge entnommen: Zuletzt hinein, zuerst heraus (LIFO). Mit top() liest du den obersten Wert, ohne ihn zu entfernen.

Bei einem leeren Stapel lösen sowohl pop() als auch top() eine \RuntimeException aus. null kann ein gespeicherter Wert sein und zeigt daher keinen leeren Stapel an. Wenn ein leerer Stapel zu erwarten ist, prüfe vor dem Aufruf mit isEmpty(), ob er leer ist.

Beispiele

<?php

$stack = new \SplStack();
$stack->push(10);
$stack->push(20);

echo 'top: ', $stack->top(), "\n";
while (!$stack->isEmpty()) {
    echo 'pop: ', $stack->pop(), "\n";
}

try {
    $stack->pop();
} catch (\RuntimeException $exception) {
    echo "empty: RuntimeException\n";
}

Ergebnis

top: 20
pop: 20
pop: 10
empty: RuntimeException

Im Kommandozeilenbeispiel für PHP 8.3 zeigt `top()` den Wert `20`, ohne ihn zu entfernen. Die Schleife entnimmt `20` und `10`. Der letzte Aufruf versucht absichtlich, ein Element vom leeren Stapel zu nehmen, und zeigt, wie die Ausnahme abgefangen wird.

Zugehörige Lektionen

  • PHP · Lektion 64 · Fortgeschritten · Version: 2

Quellen