База знанияИзпитен център
BGБългарски
Избери език13

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

Източници