CKTIS / PHP
SplQueue::count — Größe der Warteschlange ermitteln
Mit `SplQueue::count` ermittelst du die aktuelle Anzahl der Elemente in einer FIFO-Warteschlange, ohne etwas zu entfernen. Bei einer leeren Warteschlange ist das Ergebnis `0`.
Version: PHP 8.3
Syntax
public function count(): int // The inherited return type is tentative in PHP 8.3.
$queue->count();
\count($queue);SplQueue::count ist eine öffentliche Instanzmethode, die von SplDoublyLinkedList::count geerbt wird. Rufe sie als $queue->count() auf: Das :: im Symbolnamen steht hier nicht für einen statischen Aufruf. Die Methode nimmt keine Argumente entgegen und gibt die aktuelle Anzahl der Elemente als int zurück, bei einer leeren Warteschlange also 0.
Beim Zählen wird die Warteschlange nicht durchlaufen, der Iterator nicht bewegt und kein Element entfernt, auch nicht im Modus IT_MODE_DELETE. Jeder eingereihte Wert zählt als ein Element, auch wenn er ein Array ist. Da SplQueue über seine Basisklasse Countable implementiert, liefert die globale Funktion \count($queue) dasselbe Ergebnis. Die Methode akzeptiert keinen Zählmodus.
In einer FIFO-Warteschlange fügt enqueue() hinten ein Element hinzu, während dequeue() das vorderste Element entfernt und zurückgibt. Das Ergebnis von count() beschreibt den Zustand zum Zeitpunkt des Aufrufs. Wenn du nur wissen willst, ob die Warteschlange leer ist, verwende $queue->isEmpty(). Anders als das Zählen löst dequeue() bei einer leeren Warteschlange eine RuntimeException aus.
Das Beispiel ist für PHP 8.3 gedacht. Die Klasse \SplQueue gehört zur SPL, die in Standard-Builds von PHP 8.3 immer aktiviert ist.
Beispiele
<?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";
Ergebnis
0 2 2 A 1
Das erste Ergebnis ist `0`. Nach dem Einreihen von zwei Werten liefern beide Zählvarianten `2`: `['B', 'C']` ist ein Warteschlangenelement. `dequeue()` gibt `A` zurück, sodass `1` Element übrig bleibt.
Zugehörige Lektionen
- PHP · Lektion 65 · Fortgeschritten · Version: 2