CKTIS / PHP
SplStack::push — Přidání hodnoty na vrchol zásobníku
Metoda push() přidá jednu hodnotu do existujícího zásobníku SplStack. Pokud se vrchol zásobníku mezitím nezmění, příští volání pop() tuto hodnotu odebere a vrátí.
Verze: PHP 8.3
Syntaxe
public function SplDoublyLinkedList::push(mixed $value): void
$stack = new \SplStack();
$stack->push($value);SplStack::push je veřejná instanční metoda zděděná z třídy SplDoublyLinkedList. Volání $stack->push($value) přidá prvek na konec obousměrně propojeného seznamu, tedy na vrchol zásobníku. Zápis s :: označuje metodu, neznamená však statické volání. Třída je součástí SPL. Ve standardním PHP 8.3 je rozšíření SPL vždy povolené a v konfiguraci PHP ho nelze vypnout. Zápis new \SplStack() vybere třídu z globálního jmenného prostoru.
Každé volání přijímá právě jednu hodnotu typu mixed, včetně null. Pole předané jako $value se uloží jako jeden prvek, nikoli jako několik samostatných prvků. Metoda mění existující objekt a má návratový typ void: nevrací počet prvků ani zásobník pro řetězení volání.
pop() odebere a vrátí hodnotu ze stejného konce. Dvojice push() a pop() proto funguje podle principu LIFO: naposledy přidaný prvek se odebere jako první. top() vrátí hodnotu z vrcholu, aniž ji odebere. Obě metody vyvolají výjimku \RuntimeException, pokud je zásobník prázdný. Pokud může být prázdný, ověř to nejprve pomocí isEmpty(). Režim iterace neurčuje, který konec používají push() a pop().
Příklady
<?php
$stack = new \SplStack();
$stack->push('first');
$stack->push('second');
echo 'top: ', $stack->top(), "\n";
while (!$stack->isEmpty()) {
echo 'pop: ', $stack->pop(), "\n";
}
Výsledek
top: second pop: second pop: first
`second` se vypíše dvakrát: `top()` hodnotu přečte a první volání `pop()` ji odebere. Další volání `pop()` odebere `first`. Cyklus skončí dříve, než by zavolal `pop()` na prázdném zásobníku.
Související lekce
- PHP · Lekce 64 · Pokročilá · Verze: 2