CKTIS / PHP
SplFixedArray::count — obter o tamanho atual
`SplFixedArray::count()` devolve o número atual de posições, incluindo as que contêm `null`, e não o número de valores diferentes de `null`.
Versão: PHP 8.3; extension availability may vary
Sintaxe
public function count(): intSplFixedArray::count é um método de instância sem parâmetros. A chamada $array->count() devolve o tamanho atual como int, sem alterar o array. O construtor inicializa cada posição com null, mas todas as posições entram na contagem. Atribuir um valor a uma posição existente não altera o resultado.
$array->getSize() devolve o mesmo tamanho. Embora SplFixedArray implemente a interface Countable, para uma instância da própria classe SplFixedArray (e não de uma subclasse), a função global \count($array) obtém o tamanho diretamente através do mecanismo interno de contagem do PHP, sem chamar o método público count(). A notação :: identifica o método na documentação; para o chamar num objeto, usa ->.
Para alterar explicitamente o tamanho, usa $array->setSize($size). Ao aumentar o tamanho, as novas posições são inicializadas com null; ao reduzi-lo, as posições fora do novo intervalo e os seus valores são eliminados. Para contar apenas os valores diferentes de null, percorre o array e conta só os que satisfazem $value !== null.
Exemplos
<?php
$array = new \SplFixedArray(3);
echo $array->count(), "\n";
$array[1] = 'PHP';
echo $array->count(), ' ', \count($array), ' ', $array->getSize(), "\n";
$array->setSize(5);
echo $array->count(), "\n";
Resultado
3 3 3 3 5
Inicialmente, as três posições contêm `null`. Depois de guardar `'PHP'` no índice `1`, as três formas de consultar o tamanho continuam a devolver `3`. Só `setSize(5)` altera o tamanho para `5`.
Lições relacionadas
- PHP · Lição 66 · Avançado · Versão: 2