CKTIS / PHP
SplQueue::count — Compter les éléments d’une file
`SplQueue::count` donne le nombre actuel d’éléments dans une file FIFO sans en retirer. Si la file est vide, le résultat est `0`.
Version : PHP 8.3
Syntaxe
public function count(): int // The inherited return type is tentative in PHP 8.3.
$queue->count();
\count($queue);SplQueue::count est une méthode d’instance publique héritée de SplDoublyLinkedList::count. Appelle-la avec $queue->count() : le :: dans le nom du symbole n’indique pas un appel statique. La méthode ne prend aucun argument et renvoie le nombre actuel d’éléments sous forme d’int, soit 0 si la file est vide.
Le comptage ne parcourt pas la file, ne déplace pas son itérateur et ne retire aucun élément, même en mode IT_MODE_DELETE. Chaque valeur ajoutée compte pour un élément, même si c’est un tableau. Comme SplQueue implémente Countable par l’intermédiaire de sa classe parente, la fonction globale \count($queue) renvoie le même résultat. La méthode n’accepte pas de mode de comptage.
Dans une file FIFO, enqueue() ajoute un élément en fin de file, tandis que dequeue() retire et renvoie l’élément en tête. Le résultat de count() décrit l’état de la file au moment de l’appel. Pour savoir seulement si la file est vide, utilise $queue->isEmpty(). Contrairement au comptage, dequeue() lève une RuntimeException si la file est vide.
L’exemple cible PHP 8.3. La classe \SplQueue fait partie de la SPL, qui est toujours activée dans les compilations standard de PHP 8.3.
Exemples
<?php
$queue = new \SplQueue();
echo $queue->count(), "\n";
$queue->enqueue('A');
$queue->enqueue(['B', 'C']);
echo $queue->count(), "\n";
echo \count($queue), "\n";
echo $queue->dequeue(), "\n";
echo $queue->count(), "\n";
Résultat
0 2 2 A 1
Le premier résultat est `0`. Après l’ajout de deux valeurs, les deux formes de comptage renvoient `2` : `['B', 'C']` constitue un seul élément de la file. `dequeue()` renvoie `A` ; il reste donc `1` élément.
Leçons associées
- PHP · Leçon 65 · Avancé · Version : 2