Obtém o primeiro valor de um array

# array_first

(PHP 8 >= 8.5.0)

array_first — Obtém o primeiro valor de um array

### Descrição

function array_first(array `$array`): mixed

Obtém o primeiro valor do `array` fornecido.

### Parâmetros

`array`
  Um array.

### Valor Retornado

Retorna o primeiro valor de `array` se o array não estiver vazio; `null` caso contrário.

### Exemplos

Exemplo #1 Uso básico de array_first()

    <?php
    $array = [1 => 'a', 0 => 'b', 3 => 'c', 2 => 'd'];

    $firstValue = array_first($array);

    var_dump($firstValue);
    ?>

O exemplo acima produzirá:

    string(1) "a"

### Veja Também

- array_key_first() - Obtém a primeira chave de um array
- array_last() - Obtém o último valor de um array

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