Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / PHP

SplStack::top — consultar la cima de una pila sin extraerla

`SplStack::top` devuelve el valor de la cima de una pila sin extraer el elemento. Si la pila está vacía, lanza una `\RuntimeException`.

Versión: PHP 8.3

Sintaxis

public function top(): mixed

$stack->top()

SplStack::top es un método público de instancia heredado de SplDoublyLinkedList. Llámalo sobre un objeto con $stack->top(), sin argumentos. Devuelve el valor del último nodo de la lista doblemente enlazada, que corresponde a la cima de la pila, y deja el nodo en su sitio.

push() añade un elemento a la cima. En el orden LIFO (último en entrar, primero en salir), el último elemento añadido es el primero que se extrae. Usa top() para consultar el valor y pop() para obtenerlo y extraer el elemento. A diferencia de current(), top() no depende de la posición del iterador.

El tipo de retorno mixed incluye null, por lo que null puede ser un valor almacenado y no indica que la pila esté vacía. Si está vacía, top() lanza una \RuntimeException. Si es normal que la pila pueda estar vacía, compruébalo con isEmpty() antes de llamar al método.

El ejemplo está pensado para PHP 8.3, que incorpora SPL. En código con espacio de nombres, usa los nombres completos \SplStack y \RuntimeException o importa estas clases.

Ejemplos

<?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";
}

Resultado

B
B
B
A
RuntimeException

Las dos llamadas a `top()` imprimen `B`. El primer `pop()` imprime y extrae `B`, así que el siguiente `top()` imprime `A`. Tras extraer `A`, el bloque `catch` imprime el texto fijo `RuntimeException`, no el mensaje de la excepción.

Lecciones relacionadas

  • PHP · Lección 64 · Avanzado · Versión: 2

Fuentes