array_keys

(PHP 4 )

array_keys -- Retorna todas as chaves de um array

Descrição

array array_keys ( array input [, mixed search_value])

array_keys() retorna as chaves, numéricas e string, do array input.

Se o parâmetro opcional search_value for especificado, então apenas as chaves para esse valor serão retornadas. Do contrário, todas as chaves de input serão retornadas.

Exemplo 1. Exemplo de array_keys()

$array = array (0 => 100, "cor" => "vermelho");
print_r(array_keys ($array));

$array = array ("azul", "vermelho", "verde", "azul", "azul");
print_r(array_keys ($array, "azul")); 

$array = array ("cor" => array("azul", "vermelho", "verde"), "tamanho" => array("pequeno", "medio", "grande"));
print_r(array_keys ($array));

A saída deste programa seria:
Array
(
    [0] => 0
    [1] => cor
)
Array
(
    [0] => 0
    [1] => 3
    [2] => 4
)
Array
(
    [0] => cor
    [1] => tamanho
)

Nota: Essa função adicionada no PHP 4. Abaixo está uma implementação para aqueles que ainda usam PHP 3.

Exemplo 2. Implementação de array_keys() para usuários do PHP 3

function array_keys ($arr, $term="") {
    $t = array();
    while (list($k,$v) = each($arr)) {
        if ($term && $v != $term) {
            continue;
            $t[] = $k;
        }
        return $t;
    }
}

Veja também array_values().