concat |
Concaténation |
| Liquid (Microsoft) |
Syntaxe
|
{{ tableau1 | concat: tableau2 }}
|
Paramètres
| Nom |
Description |
| tableau1 |
Ce paramètre permet de spécifier le premier tableau auquel on souhaite ajouter un ou plusieurs éléments. |
| tableau2 |
Ce paramètre permet de spécifier le second tableau dont les éléments seront ajoutés à la fin du premier tableau. |
Description
Ce filtre permet de fusionner deux tableaux en un seul.
Remarques
- Permet de fusionner deux tableaux de manière séquentielle : Le filtre concat prend chaque élément du second tableau (tableau2) et
l'ajoute à la suite du premier tableau (tableau1), sans modifier l'ordre des éléments d'origine. Cela facilite la création de listes combinées dans une seule
opération fluide.
- Ne modifie pas les tableaux d'origine : Les tableaux utilisés comme paramètres ne sont pas modifiés en mémoire. Le résultat de concat est une
nouvelle structure contenant tous les éléments des deux tableaux. Cela permet de réutiliser les tableaux d'origine sans effet de bord.
- Les éléments du second tableau ne sont pas fusionnés récursivement : Si tableau2 contient lui-même des sous-tableaux, ceux-ci seront ajoutés comme
des éléments entiers dans tableau1, sans être décomposés. Il ne s'agit pas d'une fusion profonde, ce qui est à garder à l'esprit lors de l'utilisation avec des structures
complexes.
- Utile pour enrichir dynamiquement des listes à afficher : Ce filtre est très utile pour constituer dynamiquement un ensemble de résultats à afficher dans
une boucle, par exemple en combinant deux sources de données ou en ajoutant manuellement des éléments à un tableau issu d'une requête.
- Respecte le type tableau : ne fonctionne pas sur des chaînes : Le filtre concat est conçu exclusivement pour les structures de type tableau. Il ne
fonctionne pas pour concaténer deux chaînes de caractères. Pour cela, il faut utiliser le filtre append.
- Fonctionne aussi avec des tableaux vides sans provoquer d'erreur : Si l'un des tableaux fournis est vide, le résultat est simplement l'autre tableau
inchangé. Cela rend concat particulièrement robuste, car il n'échoue pas en cas de données manquantes ou de tableaux initialisés dynamiquement.
- Particulièrement utile dans des contextes conditionnels ou itératifs : On peut utiliser concat dans une boucle ou une logique conditionnelle pour
assembler des fragments de données de façon incrémentale, par exemple : assign resultat = resultat | concat: nouvelle_liste. Cela permet une construction progressive
d'une collection.
- Facilite la gestion de collections hétérogènes : Bien que les tableaux soient généralement homogènes, concat peut combiner des listes contenant
différents types d'objets (chaînes, entiers, objets complexes). Cela donne de la souplesse lors du traitement de données diverses dans un même tableau.
Dernière mise à jour : Jeudi, le 24 Juillet 2025