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