Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła