array_find
Retourne le premier élément validant la fonction de rappel
&reftitle.description;
mixedarray_find
arrayarray
callablecallback
array_find retourne la valeur du premier élément du
&array; pour lequel la fonction de rappel callback
retourne &true;. Si aucun élément n'est trouvé, la fonction retourne &null;.
&reftitle.parameters;
array
Le &array; à parcourir.
callback
La fonction de rappel à utiliser, qui doit respecter la signature suivante
boolcallback
mixedvalue
mixedkey
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.
&reftitle.returnvalues;
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;.
&reftitle.examples;
Exemple avec array_find
'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);
}));
?>
]]>
&example.outputs;
&reftitle.seealso;
array_find_key
array_all
array_any
array_filter
array_reduce