CKTIS / PHP
SplStack::push — Dodajanje vrednosti na vrh sklada
Metoda push() doda eno vrednost na obstoječi sklad SplStack. Naslednji klic pop() to vrednost odstrani in vrne, če se vrh sklada medtem ni spremenil.
Različica: PHP 8.3
Sintaksa
public function SplDoublyLinkedList::push(mixed $value): void
$stack = new \SplStack();
$stack->push($value);SplStack::push je javna instančna metoda, podedovana iz razreda SplDoublyLinkedList. Klic $stack->push($value) doda element na konec dvojno povezanega seznama, torej na vrh sklada. Zapis z :: označuje metodo, vendar ne pomeni statičnega klica. Razred je del SPL. V standardnem PHP 8.3 je razširitev SPL vedno omogočena in je v nastavitvah PHP ni mogoče onemogočiti. new \SplStack() izbere razred v globalnem imenskem prostoru.
Vsak klic sprejme natanko eno vrednost tipa mixed, tudi null. Tabela, podana kot $value, postane en sam element, ne pa več ločenih elementov. Metoda spremeni obstoječi objekt in ima povratni tip void: ne vrne niti števila elementov niti sklada za veriženje klicev.
pop() odstrani in vrne vrednost z istega konca. Metodi push() in pop() zato skupaj delujeta po načelu LIFO: zadnji dodani element se odstrani prvi. top() vrne vrednost z vrha, ne da bi jo odstranil. Obe metodi sprožita izjemo \RuntimeException, če je sklad prazen; če bi lahko bil prazen, to najprej preveri z isEmpty(). Način iteriranja ne določa, kateri konec uporabljata push() in pop().
Primeri
<?php
$stack = new \SplStack();
$stack->push('first');
$stack->push('second');
echo 'top: ', $stack->top(), "\n";
while (!$stack->isEmpty()) {
echo 'pop: ', $stack->pop(), "\n";
}
Rezultat
top: second pop: second pop: first
`second` se izpiše dvakrat: `top()` vrednost prebere, prvi klic `pop()` pa jo odstrani. Naslednji klic `pop()` odstrani `first`. Zanka se konča, preden bi poklicala `pop()` na praznem skladu.
Povezane lekcije
- PHP · Lekcija 64 · Napredna · Različica: 2