Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / PHP

SplStack::push — dodawanie wartości na wierzch stosu

Metoda push() dodaje jedną wartość do istniejącego stosu SplStack. Następne wywołanie pop() usunie i zwróci tę wartość, jeśli w międzyczasie wierzch stosu się nie zmieni.

Wersja: PHP 8.3

Składnia

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

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

SplStack::push to publiczna metoda instancji odziedziczona z SplDoublyLinkedList. Wywołanie $stack->push($value) dodaje element na końcu listy dwukierunkowej, czyli na wierzchu stosu. Zapis :: identyfikuje metodę, ale nie oznacza, że można ją wywołać statycznie. Klasa należy do SPL, które w standardowym PHP 8.3 jest zawsze włączone i nie można go wyłączyć w konfiguracji PHP. Zapis new \SplStack() wskazuje klasę z globalnej przestrzeni nazw.

Każde wywołanie przyjmuje dokładnie jedną wartość typu mixed, w tym null. Tablica przekazana jako $value staje się jednym elementem, a nie zbiorem osobnych elementów. Metoda modyfikuje istniejący obiekt i ma typ zwracany void: nie zwraca liczby elementów ani stosu do łączenia wywołań.

pop() usuwa i zwraca wartość z tego samego końca listy, więc para push() i pop() działa według zasady LIFO: ostatni dodany element jest zdejmowany jako pierwszy. top() zwraca wartość z wierzchu bez jej usuwania. Obie metody zgłaszają \RuntimeException, gdy stos jest pusty; jeśli nie masz pewności, czy zawiera elementy, najpierw wywołaj isEmpty(). Tryb iteracji nie decyduje o tym, którego końca używają push() i pop().

Przykłady

<?php

$stack = new \SplStack();
$stack->push('first');
$stack->push('second');

echo 'top: ', $stack->top(), "\n";

while (!$stack->isEmpty()) {
    echo 'pop: ', $stack->pop(), "\n";
}

Wynik

top: second
pop: second
pop: first

Wartość `second` pojawia się dwa razy: `top()` tylko ją odczytuje, a pierwsze wywołanie `pop()` ją usuwa. Potem `pop()` usuwa `first`. Pętla kończy się, zanim wywoła `pop()` na pustym stosie.

Powiązane lekcje

  • PHP · Lekcja 64 · Zaawansowany · Wersja: 2

Źródła