Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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

Zdroje