Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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): void

En 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

Sources