compact
current
Funções para Array
PHP Manual

# count

(PHP 4, PHP 5)

count — Conta o número de elementos de uma variável, ou propriedades de um objeto

### Descrição

int count ( mixed `$var` [, int `$mode` ] )

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.

### Parâmetros

`var`

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

### Valor Retornado

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.

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.

### Changelog

Versão | Descrição
--- | ---
4.2.0 | O parâmetro opcional `mode` foi adicionado.

### Exemplos

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
?>`

### Veja Também

- is_array() - Verifica se a variável é um array
- isset() - Informa se a variável foi iniciada
- strlen() - Retorna o tamanho de uma string

compact
current
Funções para Array
PHP Manual