CKTIS / PHP
SplQueue::enqueue — ajouter un élément en fin de file
Ajoute une valeur à la fin d’une `SplQueue`. La méthode modifie la file sur place et ne renvoie aucun résultat ; le retrait suit l’ordre FIFO.
Version : PHP 8.3
Syntaxe
public function enqueue(mixed $value): voidEn PHP 8.3, SplQueue est une classe de la SPL située dans l’espace de noms global. Dans cette version, la SPL fait partie du cœur de PHP et ne peut pas être désactivée. new \SplQueue() désigne cette classe même depuis un autre espace de noms. SplQueue::enqueue est une méthode d’instance : $queue->enqueue($value) ajoute une valeur à la fin de la file existante. mixed accepte toute valeur PHP, y compris null, et void indique que la méthode ne renvoie ni résultat ni objet permettant de chaîner les appels.
enqueue() est un alias de SplDoublyLinkedList::push(). Pour respecter l’ordre FIFO (premier entré, premier sorti), utilise dequeue() pour retirer et renvoyer l’élément en tête de file. Ne remplace pas dequeue() par pop() : pop() retire un élément en fin de file.
Appeler dequeue() sur une file vide lève une RuntimeException. Si la file risque d’être vide, vérifie son état avec isEmpty() avant le retrait. Un null renvoyé peut être une valeur stockée et non un signal indiquant que la file est vide.
Exemples
<?php
$queue = new \SplQueue();
$queue->enqueue('A');
$queue->enqueue('B');
echo $queue->dequeue(), "\n";
$queue->enqueue('C');
while (!$queue->isEmpty()) {
echo $queue->dequeue(), "\n";
}
Résultat
A B C
Après le retrait de `A`, `B` est encore en attente. `C` vient après `B`, donc la boucle affiche `B` avant `C`.
Leçons associées
- PHP · Leçon 65 · Avancé · Version : 2