Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje