Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

Fonti