CKTIS / PHP
SplStack::top — leggere la cima di una pila senza rimuoverla
`SplStack::top` restituisce il valore in cima alla pila senza rimuovere l’elemento. Se la pila è vuota, lancia una `\RuntimeException`.
Versione: PHP 8.3
Sintassi
public function top(): mixed
$stack->top()SplStack::top è un metodo pubblico di istanza ereditato da SplDoublyLinkedList. Chiamalo su un oggetto con $stack->top(), senza argomenti. Restituisce il valore dell’ultimo nodo della lista doppiamente concatenata, che corrisponde alla cima della pila, e lascia il nodo al suo posto.
push() aggiunge un elemento in cima. Con l’ordine LIFO (ultimo a entrare, primo a uscire), l’ultimo elemento aggiunto è il primo a essere rimosso. Usa top() per leggere il valore e pop() per ottenerlo e rimuovere l’elemento. A differenza di current(), top() non dipende dalla posizione dell’iteratore.
Il tipo restituito mixed include null, quindi null può essere un valore memorizzato e non indica che la pila sia vuota. Su una pila vuota, top() lancia una \RuntimeException. Se è previsto che la pila possa essere vuota, controlla con isEmpty() prima della chiamata.
L’esempio è pensato per PHP 8.3, che integra SPL. Nel codice con un namespace, usa i nomi completi \SplStack e \RuntimeException oppure importa le classi.
Esempi
<?php
$stack = new \SplStack();
$stack->push('A');
$stack->push('B');
echo $stack->top(), "\n";
echo $stack->top(), "\n";
echo $stack->pop(), "\n";
echo $stack->top(), "\n";
$stack->pop();
try {
$stack->top();
} catch (\RuntimeException $exception) {
echo "RuntimeException\n";
}
Risultato
B B B A RuntimeException
Le due chiamate a `top()` stampano `B`. Il primo `pop()` fa stampare `B` e lo rimuove, quindi il successivo `top()` stampa `A`. Dopo la rimozione di `A`, il blocco `catch` stampa il testo fisso `RuntimeException`, non il messaggio dell’eccezione.
Lezioni correlate
- PHP · Lezione 64 · Avanzato · Versione: 2