Retourne le premier élément validant la fonction de rappel

# array_find

(PHP 8 >= 8.4.0)

array_find — Retourne le premier élément validant la fonction de rappel

### Description

function array_find(array `$array`, callable `$callback`): mixed

array_find() retourne la valeur du premier élément du tableau pour lequel la fonction de rappel `callback` retourne `true`. Si aucun élément n'est trouvé, la fonction retourne `null`.

### Liste de paramètres

`array`
  Le tableau à parcourir.
`callback`

  La fonction de rappel à utiliser, qui doit respecter la signature suivante :

  function callback(mixed `$value`, mixed `$key`): bool
  Si cette fonction retourne `true`, la valeur de l'élément sera retournée par array_find() et la fonction de rappel ne sera pas appelée pour les autres éléments.

### Valeurs de retour

La fonction retourne la valeur du premier élément pour lequel le `callback` retourne `true`. Si aucun élément n'est trouvé, la fonction retourne `null`.

### Exemples

Exemple #1 Exemple avec array_find()

    <?php
    $array = [
        'a' => 'chien',
        'b' => 'vache',
        'c' => 'chat',
        'd' => 'canard',
        'e' => 'oie',
        'f' => 'éléphant'
    ];

    // Trouver le premier animal dont le nom comporte plus de 5 caractères.
    var_dump(array_find($array, function (string $value) {
        return strlen($value) > 5;
    }));

    // Trouver le premier animal dont le nom commence par f.
    var_dump(array_find($array, function (string $value) {
        return str_starts_with($value, 'f');
    }));

    // Trouver le premier animal dont la clé est la première lettre de son nom.
    var_dump(array_find($array, function (string $value, $key) {
       return $value[0] === $key;
    }));

    // Trouver le premier animal dont la clé valide une RegEx.
    var_dump(array_find($array, function ($value, $key) {
       return preg_match('/^([a-f])$/', $key);
    }));
    ?>

L'exemple ci-dessus va afficher :

    string(6) "canard"
    NULL
    string(4) "chat"
    string(5) "chien"

### Voir aussi

- array_find_key() - Retourne la clé du premier élément validant la fonction de rappel
- array_all() - Vérifie si tous les éléments du tableau valident la fonction de rappel
- array_any() - Vérifie qu'au moins un élément du tableau valide la fonction de rappel
- array_filter() - Filtre les éléments d'un tableau grâce à une fonction de rappel
- array_reduce() - Réduit itérativement un tableau

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