array_find

    (PHP 8 >= 8.4.0)

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

    Description

    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

    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(5) "canard"
NULL
string(3) "chat"
string(3) "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

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 1 note

    up
    1
    mail at nititech dot de
    7 days ago
    A simple fallback For older PHP versions, that do not have array_find:

    <?php
    function array_find(array $array, callable $callback): mixed {
    foreach (    $array as $key => $value) {
    if (    $callback($value, $key)) {
    return     $value;
    }
    }

    return     null;
    }
    ?>
    ＋add a note
    To Top