CKTIS / PHP
SplQueue::dequeue — retirer le premier élément de la file
`dequeue()` retire le premier élément d’une file FIFO et renvoie sa valeur. Une file vide provoque une exception `RuntimeException`, tandis que `null` peut être une valeur stockée.
Version : PHP 8.3
Syntaxe
public function dequeue(): mixed
$value = $queue->dequeue();En PHP 8.3, SplQueue::dequeue est une méthode d’instance publique de la classe \SplQueue de la SPL. La SPL fait partie du cœur de PHP 8.3 et ne peut pas être désactivée. L’appel $queue->dequeue() ne prend aucun argument : il retire un élément en tête de file et renvoie sa valeur, de type mixed. Comme enqueue() ajoute les éléments en fin de file, ils en sortent dans leur ordre d’insertion (FIFO).
Cette méthode est un alias de SplDoublyLinkedList::shift(). Pour consulter le premier élément sans le retirer, utilise la méthode héritée bottom(). À l’inverse, pop() retire l’élément à l’autre extrémité et renvoie sa valeur.
Appeler dequeue() sur une file vide lève une \RuntimeException. Si la file peut normalement être vide, vérifie son état avec isEmpty() avant de retirer un élément. Une valeur de retour null ou false peut être une valeur stockée, pas un signe que la file est vide.
Exemples
<?php
$queue = new \SplQueue();
$queue->enqueue('A');
$queue->enqueue(null);
$queue->enqueue('B');
while (!$queue->isEmpty()) {
echo var_export($queue->dequeue(), true), "\n";
}
try {
$queue->dequeue();
} catch (\RuntimeException $exception) {
echo get_class($exception), "\n";
}
Résultat
'A' NULL 'B' RuntimeException
La boucle affiche les trois valeurs dans leur ordre d’insertion, y compris `NULL`. Le dernier appel omet volontairement la vérification avec `isEmpty()` et affiche le nom de la classe de l’exception interceptée.
Leçons associées
- PHP · Leçon 65 · Avancé · Version : 2