CKTIS / PHP
SplQueue::count — Contar os elementos de uma fila
Usa `SplQueue::count` para saber quantos elementos estão numa fila FIFO sem retirar nenhum. Se a fila estiver vazia, o resultado é `0`.
Versão: PHP 8.3
Sintaxe
public function count(): int // The inherited return type is tentative in PHP 8.3.
$queue->count();
\count($queue);SplQueue::count é um método de instância público herdado de SplDoublyLinkedList::count. Chama-o com $queue->count(): o :: no nome do símbolo não indica uma chamada estática. O método não recebe argumentos e devolve o número atual de elementos como int, incluindo 0 se a fila estiver vazia.
A contagem não percorre a fila, não desloca o seu iterador nem remove elementos, mesmo no modo IT_MODE_DELETE. Cada valor acrescentado conta como um elemento, mesmo que seja um array. Como SplQueue implementa Countable através da classe base, a função global \count($queue) devolve o mesmo resultado. O método não aceita um modo de contagem.
Numa fila FIFO, enqueue() acrescenta um elemento no fim, enquanto dequeue() retira e devolve o primeiro elemento. O resultado de count() descreve a fila no momento da chamada. Se só precisares de saber se a fila está vazia, usa $queue->isEmpty(). Ao contrário da contagem, dequeue() lança uma RuntimeException se a fila estiver vazia.
O exemplo destina-se ao PHP 8.3. A classe \SplQueue faz parte da SPL, que está sempre ativa nas compilações padrão do PHP 8.3.
Exemplos
<?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";
Resultado
0 2 2 A 1
O primeiro resultado é `0`. Depois de acrescentar dois valores, ambas as formas de contagem devolvem `2`: `['B', 'C']` é um único elemento da fila. `dequeue()` devolve `A`, pelo que fica `1` elemento.
Lições relacionadas
- PHP · Lição 65 · Avançado · Versão: 2