CKTIS / PHP
SplStack::top — das oberste Element eines Stacks lesen
`SplStack::top` gibt den Wert des obersten Stack-Elements zurück, ohne es zu entfernen. Bei einem leeren Stack löst die Methode eine `\RuntimeException` aus.
Version: PHP 8.3
Syntax
public function top(): mixed
$stack->top()SplStack::top ist eine öffentliche Instanzmethode, die von SplDoublyLinkedList geerbt wird. Rufe sie auf einem Objekt als $stack->top() ohne Argumente auf. Sie gibt den Wert des letzten Knotens der doppelt verketteten Liste zurück. Dieser Knoten liegt oben auf dem Stack und bleibt dort.
push() legt ein Element oben auf den Stack. Nach dem LIFO-Prinzip (Last In, First Out) wird das zuletzt hinzugefügte Element zuerst entfernt. Verwende top(), um den Wert nur zu lesen, und pop(), um den Wert zu erhalten und das Element zu entfernen. Anders als current() hängt top() nicht von der Iteratorposition ab.
Der Rückgabetyp mixed schließt null ein. null kann also ein gespeicherter Wert sein und zeigt keinen leeren Stack an. Bei einem leeren Stack löst top() eine \RuntimeException aus. Wenn der Stack leer sein kann, prüfe das vor dem Aufruf mit isEmpty().
Das Beispiel ist für PHP 8.3 gedacht, in dem SPL fest integriert ist. Verwende in Code mit Namensraum die vollqualifizierten Namen \SplStack und \RuntimeException oder importiere die Klassen.
Beispiele
<?php
$stack = new \SplStack();
$stack->push('A');
$stack->push('B');
echo $stack->top(), "\n";
echo $stack->top(), "\n";
echo $stack->pop(), "\n";
echo $stack->top(), "\n";
$stack->pop();
try {
$stack->top();
} catch (\RuntimeException $exception) {
echo "RuntimeException\n";
}
Ergebnis
B B B A RuntimeException
Die beiden `top()`-Aufrufe geben `B` aus. Der erste `pop()`-Aufruf gibt `B` aus und entfernt das Element, sodass der nächste `top()`-Aufruf `A` ausgibt. Nachdem `A` entfernt wurde, gibt der `catch`-Block den festen Text `RuntimeException` aus, nicht die Ausnahmemeldung.
Zugehörige Lektionen
- PHP · Lektion 64 · Fortgeschritten · Version: 2