Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / PHP

SplStack::top — consultar o topo de uma pilha sem o remover

`SplStack::top` devolve o valor no topo de uma pilha sem remover o elemento. Se a pilha estiver vazia, lança uma `\RuntimeException`.

Versão: PHP 8.3

Sintaxe

public function top(): mixed

$stack->top()

SplStack::top é um método público de instância herdado de SplDoublyLinkedList. Chama-o num objeto com $stack->top(), sem argumentos. Devolve o valor do último nó da lista duplamente ligada, que corresponde ao topo da pilha, e deixa esse nó no lugar.

push() acrescenta um elemento no topo. Na ordem LIFO (o último a entrar é o primeiro a sair), o último elemento acrescentado é o primeiro a ser removido. Usa top() para consultar o valor e pop() para obter o valor e remover o elemento. Ao contrário de current(), top() não depende da posição do iterador.

O tipo de retorno mixed inclui null, pelo que null pode ser um valor guardado e não indica que a pilha esteja vazia. Numa pilha vazia, top() lança uma \RuntimeException. Se for de esperar que a pilha possa estar vazia, verifica com isEmpty() antes de chamar o método.

O exemplo destina-se a PHP 8.3, que inclui a SPL. Em código com um espaço de nomes, usa os nomes totalmente qualificados \SplStack e \RuntimeException ou importa essas classes.

Exemplos

<?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";
}

Resultado

B
B
B
A
RuntimeException

As duas chamadas a `top()` escrevem `B`. O primeiro `pop()` faz com que `B` seja escrito e remove-o, pelo que o `top()` seguinte escreve `A`. Depois de remover `A`, o bloco `catch` escreve o texto fixo `RuntimeException`, não a mensagem da exceção.

Lições relacionadas

  • PHP · Lição 64 · Avançado · Versão: 2

Fontes