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

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(): mixed

SplStack::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

Fontes