Verifica se uma chave ou índice existe em um array

# array_key_exists

(PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8)

array_key_exists — Verifica se uma chave ou índice existe em um array

### Descrição

function array_key_exists(string|int|float|bool|resource|null `$key`, array `$array`): bool

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.

### Parâmetros

`key`

  Valor para verificar.

`array`

  Um array com chaves para verificar.

### Valor Retornado

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.

### Registro de Alterações

Versão | Descrição
--- | ---
8.5.0 | Usar null no parâmetro `key` foi descontinuado, use uma string vazia no lugar.
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.

### Exemplos

Exemplo #1 Exemplo da função array_key_exists()

    <?php
    $searchArray = ['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
    $searchArray = ['primeiro' => null, 'segundo' => 4];

    var_dump(isset($searchArray['first']));
    var_dump(array_key_exists('first', $searchArray));
    ?>

O exemplo acima produzirá:

    bool(false)
    bool(true)

### Veja Também

- isset() - Determina se uma variável está declarada e é diferente de null
- array_keys() - Retorna todas as chaves ou uma parte das chaves de um array
- in_array() - Verifica se um valor existe em um array
- property_exists() - Verifica se o objeto ou a classe tem uma propriedade

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open