CKTIS / PHP
SplStack::pop — Retirar o elemento do topo da pilha
O método retira o elemento do topo da pilha e devolve o respetivo valor. Se a pilha estiver vazia, lança uma exceção `\RuntimeException`.
Versão: PHP 8.3
Sintaxe
$value = $stack->pop(); // $stack is a \SplStack
// Inherited signature: public function SplDoublyLinkedList::pop(): mixedSplStack::pop é um método público de instância herdado de SplDoublyLinkedList. Chama $stack->pop() sem argumentos num objeto \SplStack da SPL. O método retira o último nó da lista duplamente ligada, que corresponde ao topo da pilha, e devolve o valor guardado como mixed.
push() acrescenta um elemento ao topo. Se usares apenas push() e pop(), os elementos saem pela ordem inversa à de inserção: o último a entrar é o primeiro a sair (LIFO). Usa top() para ler o valor no topo sem o retirar.
Numa pilha vazia, tanto pop() como top() lançam uma exceção \RuntimeException. null pode ser um valor guardado, pelo que não indica que a pilha está vazia. Se for normal que a pilha esteja vazia, verifica-a com isEmpty() antes de chamares qualquer um dos métodos.
Exemplos
<?php
$stack = new \SplStack();
$stack->push(10);
$stack->push(20);
echo 'top: ', $stack->top(), "\n";
while (!$stack->isEmpty()) {
echo 'pop: ', $stack->pop(), "\n";
}
try {
$stack->pop();
} catch (\RuntimeException $exception) {
echo "empty: RuntimeException\n";
}
Resultado
top: 20 pop: 20 pop: 10 empty: RuntimeException
No exemplo para a linha de comandos do PHP 8.3, `top()` mostra `20` sem o retirar. O ciclo retira `20` e depois `10`. A última chamada tenta deliberadamente retirar um elemento da pilha vazia para mostrar como a exceção é capturada.
Lições relacionadas
- PHP · Lição 64 · Avançado · Versão: 2