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

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

Източници