Manual do PHP
Anterior |  | Próxima

# count

(PHP 3, PHP 4 , PHP 5)

count -- Conta o número de elementos de uma variável

## Descrição

int count ( mixed var [, int mode])

Retorna o número de elementos de var, que normalmente é um array (uma vez que qualquer outra coisa terá apenas um elemento).

Se var não for um array, 1 será retornado (excessão: count(`NULL`) retorna 0).

> Nota: O parâmetro opcional mode esta disponível apartir do PHP 4.2.0.

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.

Cuidado
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.

Por favor, veja a sessão Arrays do manual para uma explicação mais detalhada sobre como os arrays são implementados e utilizados no PHP.

Exemplo 1. Exemplo de 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; ?>`

Exemplo 2. Uso recursivo da função count() (PHP >= 4.2.0)
`<?php $food = array( 'fruits' => array('orange', 'banana', 'apple'), 'veggie' => array('carrot', 'collard','pea')); // recursive count echo count($food,COUNT_RECURSIVE); // mostra 8 // normal count echo count($food); // mostra2 2 ?>`

> Nota: A função sizeof() é um alias para count().

Veja também is_array(), isset() e strlen().

Anterior | Principal | Próxima
compact | Acima | current