JOIN |
Jointure |
|---|---|
| PHP 3+ | |
Syntaxe
| function join($glue,$tableau) |
Paramètres
| Nom | Description |
|---|---|
| $glue | Ce paramètre permet d'indiquer la chaîne de caractères coller entre chacun des éléments du tableau |
| $tableau | Ce paramètre permet d'indiquer le tableau à traiter |
Description
Cette fonction permet de transformer la liste du tableau en chaîne de caractères.
Remarques
- Alias de implode() : La fonction join() est simplement un alias de la fonction implode(). Elles effectuent toutes deux la même opération, consistant à concaténer les éléments d'un tableau en une seule chaîne de caractères, en insérant un séparateur entre les éléments. Bien que implode() soit plus couramment utilisée, join() est tout aussi valide.
- Facilité de concaténation d'éléments : join() est très pratique lorsqu'il s'agit de combiner les éléments d'un tableau en une chaîne de caractères. Par exemple, si vous avez un tableau contenant plusieurs valeurs et que vous souhaitez les réunir sous forme d'une seule chaîne avec des virgules entre chaque élément, join() permet d'accomplir cela en une seule ligne de code.
- Séparateur optionnel : Le premier paramètre de join() est le séparateur à insérer entre les éléments du tableau. Si ce séparateur est omis, un séparateur vide est utilisé, et les éléments du tableau sont simplement concaténés sans aucune séparation. Cela peut être utile dans certains cas où vous souhaitez une concaténation pure des éléments sans espace ou caractère entre eux.
- Ordre des paramètres : La fonction join() accepte les paramètres dans un ordre inverse par rapport à implode(). Tandis que implode() attend d'abord le séparateur, suivi du tableau, join() attend le tableau en premier, puis le séparateur. Cela peut parfois prêter à confusion, mais les deux signatures sont compatibles.
- Utilisation courante avec des tableaux de chaînes : join() est couramment utilisée pour traiter des tableaux de chaînes de caractères, comme la génération de listes de valeurs séparées par des virgules ou des espaces. Cela permet de transformer des données structurées en une chaîne formatée, par exemple lors de la génération de chaînes de requêtes SQL ou de la préparation de données pour une sortie JSON.
- Ne modifie pas le tableau d'origine : Comme beaucoup d'autres fonctions en PHP, join() ne modifie pas le tableau d'origine. Elle retourne une nouvelle chaîne étant le résultat de la concaténation des éléments du tableau. Cela permet de conserver intactes les données du tableau, ce qui peut être utile dans certains scénarios où l'intégrité des données doit être préservée.
- Gestion des tableaux multidimensionnels : Si vous utilisez join() sur un tableau multidimensionnel, vous devez d'abord aplatir ou transformer les sous-tableaux, car join() ne gère pas directement les structures imbriquées. Si vous tentez de joindre un tableau multidimensionnel, PHP retournera une erreur, ou bien il concaténera uniquement les éléments du premier niveau du tableau.
- Compatibilité avec les types de données autres que les chaînes : Si les éléments du tableau ne sont pas des chaînes, PHP les convertira automatiquement en chaînes lors de l'opération de concaténation. Par exemple, les entiers ou autres types scalaires seront convertis en chaînes avant d'être joints. Cela facilite l'utilisation de join() sur des tableaux contenant des types mixtes, bien qu'il soit toujours préférable de s'assurer que les données sont correctement formatées au préalable pour éviter des résultats inattendus.
Références
PHP 4 - Guide du développeur, Edition First Interactive, Blake Schwendiman, 2002, ISBN: 2-84427-283-5, page 540
Dernière mise à jour : Dimanche, le 5 avril 2015