array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.array-key-exists.php', 1 => 'array_key_exists', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Funções para Array', ), 'prev' => array ( 0 => 'function.array-is-list.php', 1 => 'array_is_list', ), 'next' => array ( 0 => 'function.array-key-first.php', 1 => 'array_key_first', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/array/functions/array-key-exists.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(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.
|
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 object como parâmetroarray
. Esse comportamento está descontinuado a partir do PHP 7.4.0, e removido a partir do PHP 8.0.0.Para checar a existência de uma propriedade em um objeto, property_exists() deve ser utilizada.