CKTIS / PHP
SplQueue::count — Počet prvků ve frontě
Pomocí `SplQueue::count` zjistíš aktuální počet prvků ve frontě FIFO, aniž bys některý odebral. U prázdné fronty je výsledkem `0`.
Verze: PHP 8.3
Syntaxe
public function count(): int // The inherited return type is tentative in PHP 8.3.
$queue->count();
\count($queue);SplQueue::count je veřejná instanční metoda zděděná z SplDoublyLinkedList::count. Volej ji jako $queue->count(): zápis :: v názvu symbolu neoznačuje statické volání. Metoda nepřijímá žádné argumenty a vrací aktuální počet prvků jako int, tedy 0 u prázdné fronty.
Počítání neprochází frontu, neposouvá její iterátor ani neodebírá prvky, a to ani v režimu IT_MODE_DELETE. Každá přidaná hodnota se počítá jako jeden prvek, i když jde o pole. Protože SplQueue implementuje Countable prostřednictvím rodičovské třídy, globální funkce \count($queue) vrací stejný výsledek. Metoda nepřijímá režim počítání.
Ve frontě FIFO přidává enqueue() prvek na konec, zatímco dequeue() odebere a vrátí první prvek. Výsledek count() popisuje stav fronty v okamžiku volání. Pokud chceš jen zjistit, zda je fronta prázdná, použij $queue->isEmpty(). Na rozdíl od počítání vyvolá dequeue() u prázdné fronty výjimku RuntimeException.
Příklad je určen pro PHP 8.3. Třída \SplQueue je součástí knihovny SPL, která je ve standardních sestaveních PHP 8.3 vždy zapnutá.
Příklady
<?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";
Výsledek
0 2 2 A 1
První výsledek je `0`. Po přidání dvou hodnot obě formy počítání vrátí `2`: `['B', 'C']` je jeden prvek fronty. `dequeue()` vrátí `A`, takže zbývá `1` prvek.
Související lekce
- PHP · Lekce 65 · Pokročilá · Verze: 2