CKTIS / PHP
SplStack::top — čítanie vrcholu zásobníka bez odobratia
`SplStack::top` vráti hodnotu z vrcholu zásobníka bez odobratia prvku. Pri prázdnom zásobníku vyvolá výnimku `\RuntimeException`.
Verzia: PHP 8.3
Syntax
public function top(): mixed
$stack->top()SplStack::top je verejná inštančná metóda zdedená z SplDoublyLinkedList. Volaj ju na objekte ako $stack->top(), bez argumentov. Vráti hodnotu posledného uzla obojsmerne prepojeného zoznamu, ktorý tvorí vrchol zásobníka, a ponechá uzol na mieste.
push() pridá prvok na vrchol. Pri poradí LIFO sa naposledy pridaný prvok odoberá ako prvý. Použi top(), ak chceš hodnotu len prečítať, a pop(), ak ju chceš získať a prvok zároveň odobrať. Na rozdiel od current() metóda top() nezávisí od pozície iterátora.
Návratový typ mixed zahŕňa null, takže null môže byť uložená hodnota a neznamená, že zásobník je prázdny. Pri prázdnom zásobníku vyvolá top() výnimku \RuntimeException. Ak s prázdnym zásobníkom počítaš, pred volaním over jeho stav pomocou isEmpty().
Príklad je určený pre PHP 8.3, ktorého súčasťou je knižnica SPL. V kóde s menným priestorom použi plne kvalifikované názvy \SplStack a \RuntimeException alebo triedy importuj.
Prí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ýsledok
B B B A RuntimeException
Dve volania `top()` vypíšu `B`. Prvé `pop()` vedie k vypísaniu a odobratiu `B`, takže ďalšie `top()` vypíše `A`. Po odobratí `A` blok `catch` vypíše pevne zadaný text `RuntimeException`, nie správu výnimky.
Súvisiace lekcie
- PHP · Lekcia 64 · Pokročilá · Verzia: 2