(PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8)
array_key_exists — Verifica 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.
Nota:
array_key_exists() procurará pelas chaves na primeira dimensão apenas. Chaves aninhadas em arrays multidimensionais não serão encontradas.
Versão | Descrição |
---|---|
8.0.0 |
O parâmetro key agora aceita
bool , float , int ,
null , resource e
string como argumentos.
|
8.0.0 |
Passar um object para o parâmetro array não é mais suportado.
|
7.4.0 |
Passar um object para o parâmetro array foi descontinuado. Use property_exists() em seu lugar.
|
Exemplo #1 Exemplo da função array_key_exists()
<?php
$busca_array = ['primeiro' => 1, 'segundo' => 4];
var_dump(array_key_exists('first', $searchArray));
?>
O exemplo acima produzirá:
bool(true)
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 = ['primeiro' => null, 'segundo' => 4];
var_dump(isset($searchArray['first']));
var_dump(array_key_exists('first', $searchArray));
?>
O exemplo acima produzirá:
bool(false) bool(true)