CKTIS / PHP
SplStack::push — Добавяне на стойност на върха на стека
Методът push() добавя една стойност към съществуващ стек SplStack. Следващото извикване на pop() премахва и връща тази стойност, ако върхът на стека не се е променил междувременно.
Версия: PHP 8.3
Синтаксис
public function SplDoublyLinkedList::push(mixed $value): void
$stack = new \SplStack();
$stack->push($value);SplStack::push е публичен метод на обект, наследен от SplDoublyLinkedList. Извикването $stack->push($value) добавя елемент в края на двойно свързания списък, тоест на върха на стека. Записът с :: обозначава метода, но не означава статично извикване. Класът е част от SPL. В стандартния PHP 8.3 разширението SPL винаги е включено и не може да бъде изключено чрез конфигурацията на PHP. new \SplStack() посочва класа в глобалното пространство от имена.
Всяко извикване приема точно една стойност от тип mixed, включително null. Масив, подаден като $value, се добавя като един елемент, а не като поредица от отделни елементи. Методът променя съществуващия обект и има тип на връщане void: не връща нито броя на елементите, нито стек за верижно извикване на методи.
pop() премахва и връща стойност от същия край. Затова push() и pop() заедно следват принципа LIFO: последният добавен елемент се премахва първи. top() връща стойността на върха, без да я премахва. И двата метода хвърлят \RuntimeException при празен стек; ако стекът може да е празен, първо провери с isEmpty(). Режимът на обхождане не определя кой край използват push() и pop().
Примери
<?php
$stack = new \SplStack();
$stack->push('first');
$stack->push('second');
echo 'top: ', $stack->top(), "\n";
while (!$stack->isEmpty()) {
echo 'pop: ', $stack->pop(), "\n";
}
Резултат
top: second pop: second pop: first
`second` се отпечатва два пъти: `top()` прочита стойността, а първото извикване на `pop()` я премахва. Следващото извикване на `pop()` премахва `first`. Цикълът приключва, преди да извика `pop()` върху празен стек.
Свързани уроци
- PHP · Урок 64 · Напреднало · Версия: 2