CKTIS / PHP
SplStack::push — Añadir un valor a la cima de la pila
El método push() añade un valor a una pila SplStack existente. La siguiente llamada a pop() lo retira y lo devuelve si la cima de la pila no ha cambiado entretanto.
Versión: PHP 8.3
Sintaxis
public function SplDoublyLinkedList::push(mixed $value): void
$stack = new \SplStack();
$stack->push($value);SplStack::push es un método público de instancia heredado de SplDoublyLinkedList. La llamada $stack->push($value) añade un elemento al final de la lista doblemente enlazada, que corresponde a la cima de la pila. La notación :: identifica el método, pero no indica una llamada estática. La clase forma parte de SPL. En la versión estándar de PHP 8.3, SPL está siempre habilitada y no se puede deshabilitar mediante la configuración de PHP. new \SplStack() selecciona la clase del espacio de nombres global.
Cada llamada acepta exactamente un valor de tipo mixed, incluido null. Un array pasado como $value se añade como un solo elemento, no como varios elementos independientes. El método modifica el objeto existente y tiene tipo de retorno void: no devuelve ni el número de elementos ni una pila para encadenar llamadas.
pop() retira y devuelve un valor del mismo extremo. Por eso, al combinar push() y pop(), se obtiene un orden LIFO: el último elemento añadido es el primero en salir. top() devuelve el valor de la cima sin retirarlo. Ambos métodos lanzan \RuntimeException si la pila está vacía; si puede estarlo, compruébalo antes con isEmpty(). El modo de iteración no determina qué extremo usan push() y pop().
Ejemplos
<?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 dos veces: `top()` lo lee y la primera llamada a `pop()` lo retira. La siguiente llamada a `pop()` retira `first`. El bucle termina antes de llamar a `pop()` sobre una pila vacía.
Lecciones relacionadas
- PHP · Lección 64 · Avanzado · Versión: 2