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

CKTIS / PHP

SplStack::pop — Dépiler l’élément au sommet

La méthode retire l’élément au sommet de la pile et renvoie sa valeur. Si la pile est vide, elle lève une exception `\RuntimeException`.

Version : PHP 8.3

Syntaxe

$value = $stack->pop(); // $stack is a \SplStack
// Inherited signature: public function SplDoublyLinkedList::pop(): mixed

SplStack::pop est une méthode d’instance publique héritée de SplDoublyLinkedList. Appelez $stack->pop() sans argument sur un objet \SplStack de la SPL. La méthode retire le dernier nœud de la liste doublement chaînée, c’est-à-dire le sommet de la pile, et renvoie la valeur stockée sous le type mixed.

push() ajoute un élément au sommet. Si vous utilisez uniquement push() et pop(), les éléments sortent dans l’ordre inverse de leur insertion : dernier entré, premier sorti (LIFO). Utilisez top() pour lire la valeur au sommet sans la retirer.

Sur une pile vide, pop() et top() lèvent toutes deux une exception \RuntimeException. null peut être une valeur stockée et ne signale donc pas que la pile est vide. Si une pile vide est un cas prévu, vérifiez son état avec isEmpty() avant d’appeler l’une de ces méthodes.

Exemples

<?php

$stack = new \SplStack();
$stack->push(10);
$stack->push(20);

echo 'top: ', $stack->top(), "\n";
while (!$stack->isEmpty()) {
    echo 'pop: ', $stack->pop(), "\n";
}

try {
    $stack->pop();
} catch (\RuntimeException $exception) {
    echo "empty: RuntimeException\n";
}

Résultat

top: 20
pop: 20
pop: 10
empty: RuntimeException

Dans cet exemple en ligne de commande avec PHP 8.3, `top()` affiche `20` sans le retirer. La boucle dépile ensuite `20`, puis `10`. Le dernier appel tente volontairement de dépiler sur une pile vide pour montrer comment l’exception est interceptée.

Leçons associées

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

Sources