CKTIS / PHP
SplStack::push — Adicionar um valor ao topo da pilha
O método push() adiciona um valor a uma pilha SplStack existente. A chamada seguinte a pop() remove e devolve esse valor se o topo da pilha não tiver mudado entretanto.
Versão: PHP 8.3
Sintaxe
public function SplDoublyLinkedList::push(mixed $value): void
$stack = new \SplStack();
$stack->push($value);SplStack::push é um método público de instância herdado de SplDoublyLinkedList. A chamada $stack->push($value) acrescenta um elemento ao fim da lista duplamente ligada, ou seja, ao topo da pilha. A notação :: identifica o método, mas não indica uma chamada estática. A classe faz parte da SPL. Na versão padrão do PHP 8.3, a SPL está sempre ativa e não pode ser desativada na configuração do PHP. new \SplStack() seleciona a classe no espaço de nomes global.
Cada chamada aceita exatamente um valor do tipo mixed, incluindo null. Um array passado como $value é acrescentado como um único elemento, não como vários elementos separados. O método altera o objeto existente e tem o tipo de retorno void: não devolve nem o número de elementos nem uma pilha que permita encadear chamadas.
pop() remove e devolve um valor da mesma extremidade. Em conjunto, push() e pop() seguem a ordem LIFO: o último elemento a entrar é o primeiro a sair. top() devolve o valor no topo sem o remover. Ambos os métodos lançam \RuntimeException se a pilha estiver vazia; se puder estar vazia, verifica primeiro com isEmpty(). O modo de iteração não determina a extremidade usada por push() e pop().
Exemplos
<?php
$stack = new \SplStack();
$stack->push('first');
$stack->push('second');
echo 'top: ', $stack->top(), "\n";
while (!$stack->isEmpty()) {
echo 'pop: ', $stack->pop(), "\n";
}
Resultado
top: second pop: second pop: first
`second` aparece duas vezes: `top()` lê o valor e a primeira chamada a `pop()` remove-o. A chamada seguinte a `pop()` remove `first`. O ciclo termina antes de chamar `pop()` sobre uma pilha vazia.
Lições relacionadas
- PHP · Lição 64 · Avançado · Versão: 2