Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / PHP

SplStack::push — Pridanie hodnoty na vrchol zásobníka

Metóda push() pridá jednu hodnotu do existujúceho zásobníka SplStack. Ak sa vrchol zásobníka medzitým nezmení, nasledujúce volanie pop() túto hodnotu odoberie a vráti.

Verzia: PHP 8.3

Syntax

public function SplDoublyLinkedList::push(mixed $value): void

$stack = new \SplStack();
$stack->push($value);

SplStack::push je verejná inštančná metóda zdedená z triedy SplDoublyLinkedList. Volanie $stack->push($value) pridá prvok na koniec obojsmerne prepojeného zoznamu, teda na vrchol zásobníka. Zápis s :: označuje metódu, neznamená však statické volanie. Trieda patrí do SPL. V štandardnom PHP 8.3 je rozšírenie SPL vždy zapnuté a v konfigurácii PHP sa nedá vypnúť. Zápis new \SplStack() vyberá triedu z globálneho menného priestoru.

Každé volanie prijíma presne jednu hodnotu typu mixed vrátane null. Pole odovzdané ako $value sa uloží ako jeden prvok, nie ako viacero samostatných prvkov. Metóda mení existujúci objekt a má návratový typ void: nevracia počet prvkov ani zásobník na reťazenie volaní.

pop() odoberie a vráti hodnotu z rovnakého konca. Dvojica push() a pop() preto funguje podľa princípu LIFO: naposledy pridaný prvok sa odoberie ako prvý. top() vráti hodnotu z vrcholu bez toho, aby ju odobral. Pri prázdnom zásobníku obe metódy vyvolajú výnimku \RuntimeException; ak zásobník môže byť prázdny, najprv to over pomocou isEmpty(). Režim iterácie neurčuje, ktorý koniec používajú push() a pop().

Prí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ýsledok

top: second
pop: second
pop: first

`second` sa vypíše dvakrát: `top()` hodnotu prečíta a prvé volanie `pop()` ju odoberie. Ďalšie volanie `pop()` odoberie `first`. Cyklus sa skončí skôr, než by zavolal `pop()` na prázdnom zásobníku.

Súvisiace lekcie

  • PHP · Lekcia 64 · Pokročilá · Verzia: 2

Zdroje