CKTIS / PHP
SplStack::top — odczyt wierzchołka stosu bez usuwania
`SplStack::top` zwraca wartość z wierzchołka stosu bez usuwania elementu. Na pustym stosie zgłasza wyjątek `\RuntimeException`.
Wersja: PHP 8.3
Składnia
public function top(): mixed
$stack->top()SplStack::top to publiczna metoda instancji odziedziczona z SplDoublyLinkedList. Wywołaj ją na obiekcie jako $stack->top(), bez argumentów. Zwraca wartość końcowego węzła listy dwukierunkowej, czyli wierzchołka stosu, i nie usuwa tego węzła.
push() dodaje element na wierzchołek. W porządku LIFO ostatni dodany element jest zdejmowany jako pierwszy. Użyj top(), gdy chcesz tylko odczytać wartość, a pop(), gdy chcesz ją odczytać i zarazem zdjąć element. W przeciwieństwie do current() metoda top() nie zależy od pozycji iteratora.
Typ zwracany mixed obejmuje null, więc null może być zapisaną wartością i nie oznacza pustego stosu. Na pustym stosie top() zgłasza \RuntimeException. Jeśli pusty stos jest spodziewanym stanem, sprawdź isEmpty() przed wywołaniem.
Przykład jest przeznaczony dla PHP 8.3, w którym biblioteka SPL jest wbudowana. W kodzie z przestrzenią nazw użyj pełnych nazw \SplStack i \RuntimeException albo zaimportuj te klasy.
Przykłady
<?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";
}
Wynik
B B B A RuntimeException
Dwa wywołania `top()` wypisują `B`. Pierwsze `pop()` wypisuje i zdejmuje `B`, więc następne `top()` wypisuje `A`. Po zdjęciu `A` blok `catch` wypisuje stały tekst `RuntimeException`, a nie komunikat wyjątku.
Powiązane lekcje
- PHP · Lekcja 64 · Zaawansowany · Wersja: 2