array_first

(PHP 8 >= 8.5.0)

array_first — Obtém o primeiro valor de um array

Descrição

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

Melhore Esta Página

Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema

＋adicionar nota

Notas de Usuários 2 notes

down

sunny_reitgassl at hotmail dot de ¶

27 days ago

For PHP < 8.5.0 && >= 7.3.0:

if (! function_exists("array_first")) {
    function array_first(array $array) {
        return $array ? $array[array_key_first($array)] : null;
    }
}

down

firejox at gmail dot com ¶

5 days ago

There is another Polyfill for PHP < 8.5

<?php
if (!function_exists("array_first")) {
    function array_first(array $array) {
        if (!empty($array)) return current(array_slice($array, 0, 1));
        return null;
    }
}
?>

＋adicionar nota