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