CKTIS / PHP
SplStack::top — branje vrha sklada brez odstranitve
`SplStack::top` vrne vrednost na vrhu sklada, ne da bi odstranila element. Če je sklad prazen, sproži izjemo `\RuntimeException`.
Različica: PHP 8.3
Sintaksa
public function top(): mixed
$stack->top()SplStack::top je javna metoda primerka, podedovana iz razreda SplDoublyLinkedList. Pokliči jo na objektu kot $stack->top(), brez argumentov. Vrne vrednost zadnjega vozlišča dvojno povezanega seznama, ki je na vrhu sklada, in vozlišče pusti na mestu.
push() doda element na vrh. Pri vrstnem redu LIFO se zadnji dodani element odstrani prvi. Uporabi top(), če želiš vrednost samo prebrati, in pop(), če jo želiš pridobiti in element odstraniti. Za razliko od current() metoda top() ni odvisna od položaja iteratorja.
Vračilni tip mixed vključuje null. Ta je zato lahko shranjena vrednost in ne pomeni, da je sklad prazen. Na praznem skladu top() sproži izjemo \RuntimeException. Če je prazen sklad pričakovano stanje, ga pred klicem preveri z isEmpty().
Primer je namenjen različici PHP 8.3, v katero je vgrajena knjižnica SPL. V kodi z imenskim prostorom uporabi polno kvalificirani imeni \SplStack in \RuntimeException ali uvozi razreda.
Primeri
<?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";
}
Rezultat
B B B A RuntimeException
Oba klica `top()` izpišeta `B`. Pri prvem klicu `pop()` se `B` izpiše in odstrani, zato naslednji klic `top()` izpiše `A`. Po odstranitvi `A` blok `catch` izpiše vnaprej določeno besedilo `RuntimeException`, ne sporočila izjeme.
Povezane lekcije
- PHP · Lekcija 64 · Napredna · Različica: 2