array_key_exists
(PHP 4 >= 4.0.7, PHP 5)
array_key_exists — Checa se uma chave ou índice existe em um array
Descrição
array_key_exists() retorna TRUE se a chave
key existe no array.
key pode ser qualquer valor possível para uma
chave de array. array_key_exists() também
funciona com objetos.
Parâmetros
-
key -
Valor para verificar.
-
search -
Um array com chaves para verificar.
Valor Retornado
Retorna TRUE em caso de sucesso ou FALSE em caso de falha.
Exemplos
Example #1 Exemplo de array_key_exists()
<?php
$busca_array = array("primeiro" => 1, "segundo" => 4);
if (array_key_exists("primeiro", $busca_array)) {
echo "O elemento 'primeiro' está no array!";
}
?>
Note: O nome dessa função é key_exists() no PHP 4.0.6.
Example #2 array_key_exists() versus isset()
isset() não retorna TRUE para valores de chave
que correspondam a um valor NULL, enquanto que
array_key_exists() faz isto.
<?php
$search_array = array('first' => null, 'second' => 4);
// returns false
isset($search_array['first']);
// returns true
array_key_exists('first', $search_array);
?>
Veja Também
- isset() - Informa se a variável foi iniciada
- array_keys() - Retorna todas as chaves de um array
- in_array() - Checa se um valor existe em um array