====== Syntaxe ======
Deux syntaxes sont possibles.

Sans spécifier de séparateur:
<code>@concat(valeur1,valeur2,...,valeurN)</code>

En spécifiant un séparateur:

<code>@concat('@sep:separateur',valeur1,valeur2,...,valeurN)</code>

Où //separateur// peut être le caractère (ou chaîne de caractères) de votre choix à l'exception du caractère quote simple.

Chaque valeur peut être :
  * Une chaîne de caractères encadrée par des quotes simples.
  * Un numérique.
  * [[cold:reference:coldfldformat:self|@self]] : une référence à la valeur du champ lui-même.
  * [[cold:reference:groupname|@<groupname>]] : une référence à un group de capture (effectuée dans le filtre de champ).

====== Description ======
**@concat** permet de concaténer les valeurs de chacun des paramètres qui lui sont fournis.

Il est également possible de sépcifier un séparateur.

{{wiki:icons:info.png}} Elle vous permet de réaliser des opérations de concaténation directement dans votre champ de recherche variable sans passer par un second champ de type spécifique.

====== Exemples ======
Considérons le texte extrait suivant:
<file text.txt>

                                                                                            HYMEO
                                                                                           230 Rue de l'Industrie


                                                                                           34400 LUNEL
                                                                                           FRANCE

                                                                                           calmar, le 31 Août 2011
     I   FACTURE N ° CM/111080594
                                                                                           ORIGINAL CLIENT
    Référence client : 6733             
    
    141HYMEO0001

    Date de livraison estimée         Du 10/08/2015    au    12/08/2015

         Enlèvement de 4 spas + couvercles le 02/08                                             50,00 1


         Enlèvement de 6 spas + couvercles le 06/08                                             50,00 1




           Montant N.T.       Code Taux TVA             Montant TVA       Total H.T.           100,00 
                   100,00 1                19.60                    19,60 Total T.V.A.         19,60 
                                                                             TOTAL T.T.C.      119,60

     A 30 jours date de facture
     Echéance : 30/09/2011                                                   RESTE DU          119,60 
     Facture arrêtée à la somme de : cent dix-neuf euros et 60 cents
     WA acquittée sur les encaissements

</file>

Nous créons un champ de type variable avec l'expression suivante dans le filtre de champ:
  FACTURE N . (?P<code>[A-Z]{2})/(?P<num>\d+)
  
Nous recherchons la désignation de la facture. Elle est composée d'un code de deux lettres majuscules suivies du caractère **/** suivi de plusieurs chiffres. Nous capturons le code de deux lettre dans la variable <code> et les chiffres dans la variable <num>.

Donc dans notre exemple
  <code> = CM
  <num>  = 111080594
  
Ainsi cette concaténation sans séparateur :
  @concat(@<num>,@<numero>)
  
nous donne comme résultat
  CM111080594

Tandis que cette concaténation avec le séparateur **-** :
  @concat('@sep:-',@<code>,@<num>)
  
a pour résultat:
  CM-111080594