CKTIS / PHP
SplStack::top — čitanje vrha stoga bez uklanjanja
`SplStack::top` vraća vrijednost s vrha stoga bez uklanjanja elementa. Ako je stog prazan, metoda baca iznimku `\RuntimeException`.
Verzija: PHP 8.3
Sintaksa
public function top(): mixed
$stack->top()SplStack::top javna je metoda instance naslijeđena iz klase SplDoublyLinkedList. Pozovi je na objektu kao $stack->top(), bez argumenata. Vraća vrijednost posljednjeg čvora dvostruko povezanog popisa, koji je na vrhu stoga, i ostavlja čvor na mjestu.
push() dodaje element na vrh. Prema načelu LIFO, posljednji dodani element uklanja se prvi. Upotrijebi top() ako želiš samo pročitati vrijednost, a pop() ako želiš dobiti vrijednost i ukloniti element. Za razliku od current(), top() ne ovisi o položaju iteratora.
Povratni tip mixed uključuje null, pa null može biti pohranjena vrijednost i ne znači da je stog prazan. Na praznom stogu top() baca iznimku \RuntimeException. Ako je prazan stog očekivano stanje, provjeri ga metodom isEmpty() prije poziva.
Primjer je namijenjen PHP-u 8.3, u koji je ugrađena biblioteka SPL. U kodu s imenskim prostorom upotrijebi potpuno kvalificirana imena \SplStack i \RuntimeException ili uvezi te klase.
Primjeri
<?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
Dva poziva metode `top()` ispisuju `B`. Pri prvom pozivu metode `pop()` vrijednost `B` se ispisuje i uklanja, pa sljedeći poziv metode `top()` ispisuje `A`. Nakon uklanjanja `A` blok `catch` ispisuje zadani tekst `RuntimeException`, a ne poruku iznimke.
Povezane lekcije
- PHP · Lekcija 64 · Napredno · Verzija: 2