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