Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes