CKTIS / PHP
SplStack::push — Aggiungere un valore in cima alla pila
Il metodo push() aggiunge un valore a una pila SplStack esistente. La chiamata successiva a pop() lo rimuove e lo restituisce se nel frattempo la cima della pila non è cambiata.
Versione: PHP 8.3
Sintassi
public function SplDoublyLinkedList::push(mixed $value): void
$stack = new \SplStack();
$stack->push($value);SplStack::push è un metodo pubblico di istanza ereditato da SplDoublyLinkedList. La chiamata $stack->push($value) aggiunge un elemento in coda alla lista doppiamente concatenata, cioè in cima alla pila. La notazione :: identifica il metodo, ma non indica una chiamata statica. La classe fa parte di SPL. Nella versione standard di PHP 8.3, SPL è sempre attiva e non può essere disattivata tramite la configurazione di PHP. new \SplStack() seleziona la classe nello spazio dei nomi globale.
Ogni chiamata accetta esattamente un valore di tipo mixed, incluso null. Un array passato come $value viene aggiunto come un singolo elemento, non come una serie di elementi separati. Il metodo modifica l’oggetto esistente e ha tipo di ritorno void: non restituisce né il numero di elementi né una pila per concatenare le chiamate.
pop() rimuove e restituisce un valore dalla stessa estremità. Usando insieme push() e pop() si ottiene quindi l’ordine LIFO: l’ultimo elemento aggiunto è il primo a uscire. top() restituisce il valore in cima senza rimuoverlo. Entrambi i metodi lanciano \RuntimeException se la pila è vuota; se potrebbe esserlo, verifica prima con isEmpty(). La modalità di iterazione non determina l’estremità usata da push() e pop().
Esempi
<?php
$stack = new \SplStack();
$stack->push('first');
$stack->push('second');
echo 'top: ', $stack->top(), "\n";
while (!$stack->isEmpty()) {
echo 'pop: ', $stack->pop(), "\n";
}
Risultato
top: second pop: second pop: first
`second` compare due volte: `top()` lo legge e la prima chiamata a `pop()` lo rimuove. La chiamata successiva a `pop()` rimuove `first`. Il ciclo termina prima di chiamare `pop()` su una pila vuota.
Lezioni correlate
- PHP · Lezione 64 · Avanzato · Versione: 2