Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje