(PHP 4, PHP 5, PHP 7)
count — Conta o número de elementos de uma variável, ou propriedades de um objeto
Conta os elementos de um array, ou propriedades em um objeto.
Para objetos, se você tem SPL instalada, você pode fazer um gancho na count() implementando a interface Countable. A interface tem exatamente um método, count(), que retorna o valor retornado para função count().
Por favor, veja a sessão Array do manual para uma explicação mais detalhada sobre como os arrays são implementados e utilizados no PHP.
varThe array.
mode
Se o parâmetro opcional mode for
COUNT_RECURSIVE (ou 1), a função count()
irá recursivamente contar a matriz. Isto é particularmente util
para contar elementos em matriz multidimensional.
O valor padrão para mode é 0.
count() não detecta infinita recursão.
Retorna o número de elementos em var, que normalmente
é um array, pois qualquer outra coisa terá somente um elemento.
Se var não for um array ou um objeto, com a
interface Countable implementada,
1 será retornado.
Há uma exceção, se var é NULL,
0 é retornado.
count() pode retornar 0 para uma variável que não existe, mas também pode retornar 0 para uma variável que tenha sido inicializada como um array vazio. Use isset() para checar se a variável existe.
| Versão | Descrição |
|---|---|
| 4.2.0 |
O parâmetro opcional mode foi adicionado.
|
Exemplo #1 Exemplo da função count()
<?php
$a[0] = 1;
$a[1] = 3;
$a[2] = 5;
$result = count($a);
// $result == 3
$b[0] = 7;
$b[5] = 9;
$b[10] = 11;
$result = count($b);
// $result == 3
$result = count(null);
// $result == 0
$result = count(false);
// $result == 1
?>
Exemplo #2 Uso recursivo da função count()
<?php
$comidas = array('frutas' => array('laranja', 'banana', 'maçã'),
'veggie' => array('cenoura', 'couve','ervilha'));
// contagem recursiva
echo count($comidas, COUNT_RECURSIVE); // mostra 8
// contagem normal
echo count($comidas); // mostra 2
?>