(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.
keyValor para verificar.
arrayUm 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)