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