Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje