CKTIS / PHP
SplQueue::isEmpty — Vérifier si une file est vide
`isEmpty()` vérifie qu'une `SplQueue` ne contient aucun élément. Utilisez cette méthode avant `dequeue()` pour distinguer une file vide d'une file contenant `null` ou `false`.
Version : PHP 8.3
Syntaxe
public function isEmpty(): bool
$queue->isEmpty()SplQueue::isEmpty est une méthode d'instance publique héritée de SplDoublyLinkedList. Appelez-la sans argument avec $queue->isEmpty(), et non de façon statique. Elle renvoie un bool : true si la file ne contient aucun élément, false si elle en contient au moins un. Elle ne retire aucun élément et ne fait pas avancer l'itérateur.
Le test porte sur l'état actuel de la file, pas sur les valeurs qu'elle contient : null, false et 0 comptent comme des éléments. $queue->count() === 0 répond à la même question, mais isEmpty() exprime directement l'intention. La construction du langage empty($queue) ne vérifie pas le nombre d'éléments contenus dans l'objet SplQueue.
enqueue() ajoute un élément en fin de file, tandis que dequeue() retire et renvoie l'élément en tête (FIFO : premier entré, premier sorti). Sur une file vide, dequeue() lève une RuntimeException. Pour vider la file, testez !$queue->isEmpty() avant chaque retrait. L'exemple cible PHP 8.3, qui intègre SPL sans possibilité de la désactiver. \SplQueue désigne la classe dans l'espace de noms global.
Exemples
<?php
$queue = new \SplQueue();
var_dump($queue->isEmpty());
$queue->enqueue(null);
$queue->enqueue(false);
var_dump($queue->isEmpty());
while (!$queue->isEmpty()) {
var_dump($queue->dequeue());
}
var_dump($queue->isEmpty());
Résultat
bool(true) bool(false) NULL bool(false) bool(true)
La nouvelle file renvoie `true`, puis `false` après deux ajouts. La boucle affiche `NULL`, puis `bool(false)`. Ce sont les valeurs retirées ; le dernier `bool(true)` indique que la file est de nouveau vide.
Leçons associées
- PHP · Leçon 65 · Avancé · Version : 2