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

CKTIS / PHP

SplStack::push — Empiler une valeur

La méthode push() ajoute une valeur à une pile SplStack existante. Le prochain appel à pop() retire et renvoie cette valeur si le sommet de la pile n’a pas changé entre-temps.

Version : PHP 8.3

Syntaxe

public function SplDoublyLinkedList::push(mixed $value): void

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

SplStack::push est une méthode d’instance publique héritée de SplDoublyLinkedList. L’appel $stack->push($value) ajoute un élément à la fin de la liste doublement chaînée, c’est-à-dire au sommet de la pile. La notation :: identifie la méthode, mais n’indique pas un appel statique. La classe fait partie de SPL. Dans la version standard de PHP 8.3, SPL est toujours activée et ne peut pas être désactivée dans la configuration de PHP. new \SplStack() désigne la classe de l’espace de noms global.

Chaque appel accepte exactement une valeur de type mixed, y compris null. Un tableau passé comme $value devient un seul élément de la pile, et non une série d’éléments distincts. La méthode modifie l’objet existant et son type de retour est void : elle ne renvoie ni le nombre d’éléments ni une pile permettant de chaîner les appels.

pop() retire et renvoie une valeur à la même extrémité. Utilisées ensemble, push() et pop() suivent donc l’ordre LIFO : le dernier élément ajouté est retiré en premier. top() renvoie la valeur au sommet sans la retirer. Ces deux méthodes lèvent une \RuntimeException si la pile est vide ; si elle peut l’être, vérifiez d’abord avec isEmpty(). Le mode d’itération ne détermine pas l’extrémité utilisée par push() et pop().

Exemples

<?php

$stack = new \SplStack();
$stack->push('first');
$stack->push('second');

echo 'top: ', $stack->top(), "\n";

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

Résultat

top: second
pop: second
pop: first

`second` apparaît deux fois : `top()` lit la valeur, puis le premier appel à `pop()` la retire. L’appel suivant à `pop()` retire `first`. La boucle s’arrête avant d’appeler `pop()` sur une pile vide.

Leçons associées

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

Sources