Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła