CKTIS / PHP
SplStack::top — přečtení vrcholu zásobníku bez odebrání
`SplStack::top` vrací hodnotu z vrcholu zásobníku, aniž by prvek odebrala. U prázdného zásobníku vyvolá výjimku `\RuntimeException`.
Verze: PHP 8.3
Syntaxe
public function top(): mixed
$stack->top()SplStack::top je veřejná instanční metoda zděděná z SplDoublyLinkedList. Volej ji na objektu jako $stack->top(), bez argumentů. Vrací hodnotu posledního uzlu obousměrně vázaného seznamu, který tvoří vrchol zásobníku, a ponechává uzel na místě.
push() přidá prvek na vrchol. V pořadí LIFO se naposledy vložený prvek odebírá jako první. Použij top(), když chceš hodnotu jen přečíst, a pop(), když chceš hodnotu získat a prvek zároveň odebrat. Na rozdíl od current() metoda top() nezávisí na pozici iterátoru.
Návratový typ mixed zahrnuje null. Hodnota null tedy může být v zásobníku uložena a neznamená, že je zásobník prázdný. U prázdného zásobníku vyvolá top() výjimku \RuntimeException. Pokud s prázdným zásobníkem počítáš, ověř jeho stav před voláním pomocí isEmpty().
Příklad je určen pro PHP 8.3, jehož součástí je knihovna SPL. V kódu se jmenným prostorem použij plně kvalifikované názvy \SplStack a \RuntimeException nebo třídy importuj.
Příklady
<?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";
}
Výsledek
B B B A RuntimeException
Dvě volání `top()` vypíšou `B`. První `pop()` způsobí výpis a odebrání `B`, takže další `top()` vypíše `A`. Po odebrání `A` blok `catch` vypíše pevně zadaný text `RuntimeException`, nikoli zprávu výjimky.
Související lekce
- PHP · Lekce 64 · Pokročilá · Verze: 2