Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / PHP

SplStack::top — lire le sommet d’une pile sans le retirer

`SplStack::top` renvoie la valeur au sommet d’une pile sans retirer l’élément. Si la pile est vide, la méthode lève une `\RuntimeException`.

Version : PHP 8.3

Syntaxe

public function top(): mixed

$stack->top()

SplStack::top est une méthode d’instance publique héritée de SplDoublyLinkedList. Appelez-la sur un objet avec $stack->top(), sans argument. Elle renvoie la valeur du dernier nœud de la liste doublement chaînée, qui correspond au sommet de la pile, et laisse ce nœud en place.

push() ajoute un élément au sommet. Selon le principe LIFO (dernier entré, premier sorti), le dernier élément ajouté est le premier retiré. Utilisez top() pour consulter la valeur, ou pop() pour l’obtenir tout en retirant l’élément. Contrairement à current(), top() ne dépend pas de la position de l’itérateur.

Le type de retour mixed inclut null : null peut donc être une valeur stockée et n’indique pas que la pile est vide. Sur une pile vide, top() lève une \RuntimeException. Si la pile peut être vide, vérifiez-le avec isEmpty() avant l’appel.

L’exemple cible PHP 8.3, qui intègre SPL. Dans un espace de noms, utilisez les noms pleinement qualifiés \SplStack et \RuntimeException, ou importez ces classes.

Exemples

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

Résultat

B
B
B
A
RuntimeException

Les deux appels à `top()` affichent `B`. Le premier `pop()` affiche et retire `B`, donc le `top()` suivant affiche `A`. Après le retrait de `A`, le bloc `catch` affiche le texte fixe `RuntimeException`, et non le message de l’exception.

Leçons associées

  • PHP · Leçon 64 · Avancé · Version : 2

Sources