CKTIS / PHP
SplStack::isEmpty — vérifier si une pile est vide
`isEmpty()` vérifie qu’une pile `SplStack` ne contient aucun élément. Une pile qui contient uniquement la valeur `false` n’est pas vide.
Version : PHP 8.3
Syntaxe
public function isEmpty(): bool
$stack->isEmpty()SplStack::isEmpty est une méthode d’instance publique héritée de SplDoublyLinkedList. Elle ne prend aucun argument et renvoie un bool : true si la pile ne contient aucun élément, false si elle en contient au moins un. Appelez-la sur un objet avec $stack->isEmpty(), et non statiquement avec ::. L’exemple cible PHP 8.3. Dans cette version, SPL fait partie du cœur de PHP et ne peut pas être désactivée. Le nom \SplStack désigne la classe dans l’espace de noms global.
La méthode ne retire aucun élément et ne déplace pas l’itérateur. Elle examine le contenu de toute la pile, et non la position courante de l’itérateur comme le fait valid(). Les valeurs false, 0 et null comptent comme des éléments. La construction empty($stack) ne vérifie pas que la pile contient zéro élément.
Avant d’appeler pop(), utilisez !$stack->isEmpty() pour vérifier qu’il reste un élément. Sur une pile vide, pop() lève une RuntimeException. N’interprétez pas un retour false comme le signe que la pile était vide : il peut s’agir de la valeur retirée.
Exemples
<?php
$stack = new \SplStack();
var_dump($stack->isEmpty());
$stack->push(false);
var_dump($stack->isEmpty());
if (!$stack->isEmpty()) {
var_dump($stack->pop());
}
var_dump($stack->isEmpty());
Résultat
bool(true) bool(false) bool(false) bool(true)
La troisième ligne, `bool(false)`, affiche la valeur retirée. La deuxième ligne est identique, mais indique que la pile n’était pas vide avant le retrait.
Leçons associées
- PHP · Leçon 64 · Avancé · Version : 2