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

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

Fontes