CKTIS / PHP
SplQueue::count — Het aantal elementen in een wachtrij
Gebruik `SplQueue::count` om het huidige aantal elementen in een FIFO-wachtrij op te vragen zonder iets te verwijderen. Bij een lege wachtrij is het resultaat `0`.
Versie: PHP 8.3
Syntax
public function count(): int // The inherited return type is tentative in PHP 8.3.
$queue->count();
\count($queue);SplQueue::count is een publieke instantiemethode die is geërfd van SplDoublyLinkedList::count. Roep de methode aan met $queue->count(): het teken :: in de symboolnaam duidt hier niet op een statische aanroep. De methode neemt geen argumenten aan en geeft het huidige aantal elementen terug als int, dus 0 bij een lege wachtrij.
Tellen doorloopt de wachtrij niet, verplaatst de iterator niet en verwijdert geen elementen, ook niet in de modus IT_MODE_DELETE. Elke toegevoegde waarde telt als één element, ook als het een array is. Omdat SplQueue via zijn basisklasse Countable implementeert, geeft de globale functie \count($queue) hetzelfde resultaat. De methode accepteert geen telmodus.
In een FIFO-wachtrij voegt enqueue() achteraan een element toe en verwijdert dequeue() het voorste element en geeft het terug. Het resultaat van count() beschrijft de wachtrij op het moment van de aanroep. Wil je alleen weten of de wachtrij leeg is, gebruik dan $queue->isEmpty(). Anders dan tellen gooit dequeue() bij een lege wachtrij een RuntimeException.
Het voorbeeld is bedoeld voor PHP 8.3. De klasse \SplQueue maakt deel uit van SPL, die in standaardbuilds van PHP 8.3 altijd is ingeschakeld.
Voorbeelden
<?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";
Resultaat
0 2 2 A 1
Het eerste resultaat is `0`. Nadat twee waarden zijn toegevoegd, geven beide telvormen `2` terug: `['B', 'C']` is één element in de wachtrij. `dequeue()` geeft `A` terug, zodat er `1` element overblijft.
Gerelateerde lessen
- PHP · Les 65 · Gevorderd · Versie: 2