Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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

Izvori