CKTIS / PHP
SplQueue::count — liczba elementów kolejki
Użyj metody `SplQueue::count`, aby odczytać bieżącą liczbę elementów kolejki FIFO bez ich usuwania. Dla pustej kolejki wynikiem jest `0`.
Wersja: PHP 8.3
Składnia
public function count(): int // The inherited return type is tentative in PHP 8.3.
$queue->count();
\count($queue);SplQueue::count jest publiczną metodą instancji dziedziczoną z SplDoublyLinkedList::count. Wywołaj ją jako $queue->count(): zapis :: w nazwie symbolu nie oznacza wywołania statycznego. Metoda nie przyjmuje argumentów i zwraca bieżącą liczbę elementów jako int, w tym 0 dla pustej kolejki.
Liczenie nie przechodzi po kolejce, nie przesuwa jej iteratora i nie usuwa elementów, nawet w trybie IT_MODE_DELETE. Każda dodana wartość liczy się jako jeden element, nawet jeśli jest tablicą. Ponieważ SplQueue implementuje Countable przez klasę bazową, globalna funkcja \count($queue) zwraca ten sam wynik. Metoda nie przyjmuje trybu zliczania.
W kolejce FIFO enqueue() dodaje element na końcu, a dequeue() usuwa i zwraca pierwszy element. Wynik count() opisuje stan kolejki w chwili wywołania. Jeśli chcesz tylko sprawdzić, czy kolejka jest pusta, użyj $queue->isEmpty(). W przeciwieństwie do liczenia dequeue() na pustej kolejce zgłasza RuntimeException.
Przykład jest przeznaczony dla PHP 8.3. Klasa \SplQueue należy do biblioteki SPL, która jest zawsze włączona w standardowych kompilacjach PHP 8.3.
Przykłady
<?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";
Wynik
0 2 2 A 1
Pierwszy wynik to `0`. Po dodaniu dwóch wartości oba sposoby liczenia dają `2`: `['B', 'C']` jest jednym elementem kolejki. `dequeue()` zwraca `A`, więc pozostaje `1` element.
Powiązane lekcje
- PHP · Lekcja 65 · Zaawansowany · Wersja: 2