(PHP 4 >= 4.0.7, PHP 5, PHP 7)
array_key_exists — Checa se uma chave ou índice existe em um array
array_key_exists() retorna TRUE
se a chave
key
existe no array.
key
pode ser qualquer valor possível para um
índice de um array.
key
Valor para verificar.
array
Um array com chaves para verificar.
Retorna TRUE
em caso de sucesso ou FALSE
em caso de falha.
Exemplo #1 Exemplo da função 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!";
}
?>
Exemplo #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);
?>
Nota:
Por motivo de retrocompatibilidade, a função array_key_exists() também retornará
TRUE
se o parâmetrokey
for uma propriedade definida em um dado objeto como parâmetroarray
. Não se deve confiar neste comportamento, e cuidados devem ser tomados para garantir que o parâmetroarray
seja um array.Para checar a existência de uma propriedade em um objeto, utilize a função property_exists().