CKTIS / PHP
SplStack::push — Einen Wert oben auf den Stapel legen
Mit push() legst du einen Wert auf einen vorhandenen SplStack. Der nächste Aufruf von pop() entfernt und liefert diesen Wert, sofern sich die Oberseite des Stapels nicht geändert hat.
Version: PHP 8.3
Syntax
public function SplDoublyLinkedList::push(mixed $value): void
$stack = new \SplStack();
$stack->push($value);SplStack::push ist eine öffentliche Instanzmethode, die von SplDoublyLinkedList geerbt wird. Der Aufruf $stack->push($value) fügt ein Element am Ende der doppelt verketteten Liste ein, also oben auf dem Stapel. Die Schreibweise mit :: bezeichnet die Methode, macht sie aber nicht zu einer statisch aufrufbaren Methode. Die Klasse gehört zur SPL. In Standard-PHP 8.3 ist die SPL immer aktiv und lässt sich nicht über die PHP-Konfiguration deaktivieren. new \SplStack() wählt die Klasse im globalen Namensraum.
Jeder Aufruf nimmt genau einen Wert vom Typ mixed an, auch null. Ein als $value übergebenes Array wird als einzelnes Element abgelegt, nicht als Folge mehrerer Elemente. Die Methode verändert das vorhandene Objekt und hat den Rückgabetyp void: Sie liefert weder eine Elementanzahl noch einen Stapel zum Verketten von Aufrufen.
pop() entfernt einen Wert am selben Ende und gibt ihn zurück. Zusammen folgen push() und pop() daher dem LIFO-Prinzip: Zuletzt abgelegte Elemente werden zuerst entnommen. top() gibt den obersten Wert zurück, ohne ihn zu entfernen. Beide Methoden lösen bei einem leeren Stapel eine \RuntimeException aus. Prüfe bei Bedarf vorher mit isEmpty(), ob der Stapel leer ist. Der Iterationsmodus bestimmt nicht, an welchem Ende push() und pop() arbeiten.
Beispiele
<?php
$stack = new \SplStack();
$stack->push('first');
$stack->push('second');
echo 'top: ', $stack->top(), "\n";
while (!$stack->isEmpty()) {
echo 'pop: ', $stack->pop(), "\n";
}
Ergebnis
top: second pop: second pop: first
`second` erscheint zweimal: `top()` liest den Wert nur, der erste Aufruf von `pop()` entfernt ihn. Danach entfernt `pop()` den Wert `first`. Die Schleife endet, bevor `pop()` auf einem leeren Stapel aufgerufen wird.
Zugehörige Lektionen
- PHP · Lektion 64 · Fortgeschritten · Version: 2