ARRAY_MAP

Syntaxe

Paramètres

Retour

Description

Cette fonction permet d'exécuter la fonction spécifiée sur chacun des éléments dans le ou les tableaux spécifiés.

Remarques

• Application d'une fonction sur les éléments d'un tableau : La fonction array_map() permet d'appliquer une fonction utilisateur à chaque élément d'un tableau. Cela facilite les transformations élément par élément, comme le formatage, les calculs ou la modification de valeurs existantes dans un tableau.
• Prise en charge de plusieurs tableaux : array_map() peut être utilisée avec plusieurs tableaux en tant que paramètres. Dans ce cas, la fonction utilisateur doit accepter autant de paramètres qu'il y a de tableaux. Les éléments sont passés un par un à la fonction en fonction de leur position respective.
• Retourne un nouveau tableau : Contrairement à certaines fonctions PHP modifiant les tableaux directement, array_map() retourne un nouveau tableau contenant les résultats de l'application de la fonction. Le tableau d'origine reste inchangé, ce qui préserve les données brutes.
• Fonction utilisateur optionnelle : Si aucune fonction utilisateur n'est spécifiée (en passant null comme premier paramètre), array_map() renvoie simplement une copie du tableau ou des tableaux fournis. Cela peut être utile pour créer rapidement une nouvelle instance d'un tableau sans modification.
• Compatibilité avec les clefs : Les clefs des tableaux d'origine ne sont pas modifiées par array_map(). Le tableau résultant conserve les mêmes clefs que celles des tableaux d'entrée, ce qui est pratique pour préserver les associations dans les tableaux associatifs.
• Limitation aux tableaux indexés par position : Lorsque plusieurs tableaux sont passés, array_map() itère en parallèle sur les tableaux. Si les tableaux ont des longueurs différentes, seuls les éléments jusqu'à la longueur du plus court tableau sont traités. Les éléments restants des tableaux plus longs sont ignorés.
• Utilisation avec des fonctions anonymes : array_map() s'intègre parfaitement avec les fonctions anonymes (closures). Cela permet de définir des transformations complexes directement dans l'appel de la fonction, sans avoir besoin de créer des fonctions globales séparées.
• Performances et tableaux volumineux : array_map() est généralement plus rapide et plus pratique que des boucles explicites (foreach) pour appliquer une transformation uniforme sur les éléments d'un tableau. Cependant, pour des tableaux très volumineux, le coût d'appel de la fonction utilisateur à chaque itération peut ralentir le traitement.