Fonctions Chaînes

En règle générale, les fonctions de chaînes changent l’expression d’entrée et retournent une chaîne mise à jour. L'expression d'entrée est toujours considérée comme une chaîne ; même si elle apparaît comme une date ou un nombre, elle est interprétée comme une chaîne.

Les fonctions de chaînes sont les suivantes :

Fonction LCase

La fonction LCase attribue un formatage en minuscules. Elle change l’expression en caractères minuscules et retourne une chaîne.

Syntaxe :

Lcase(expression)

Exemple :

Lcase("BONJOUR") retourne la valeur “bonjour”.

Fonction TCase

La fonction TCase attribue le formatage de style de titre. Elle change l'expression de sorte que chaque nouveau mot (commençant après un caractère non alphabétique) commence par un caractère majuscule et renvoie une chaîne.

Syntaxe :

Tcase(expression)

Exemple :

Tcase("formatting functions") renvoie la valeur "Fonctions de formatage".

Fonction UCase

La fonction UCase attribue un formatage en majuscules. Elle change l’expression en caractères majuscules et retourne une chaîne.

Syntaxe :

UCase(expression)

Exemple :

Ucase("This is it") retourne la valeur “THIS IS IT”.

Fonction Length

La fonction Length retourne le nombre de caractères dans l’expression d’entrée.

Syntaxe :

Length(expression)

Exemple :

Length("abc") renvoie la valeur de 3

Fonction IsNullOrEmpty

La fonction IsNullOrEmpty détermine si l'expression d'entrée est NULL
(par exemple, un champ source de données NULL) ou vide (par exemple, une chaîne vide ).
Cette fonction renvoie TRUE si la chaîne est NULL ou vide et FALSE sinon.

Syntaxe :

IsNullOrEmpty(expression)

Exemple :

IsNullOrEmpty(|->[Address2]) renvoie la valeur False (faux) si Address2 contient une valeur et TRUE (vrai) si le champ est NULL ou vide.

Fonction SubString

La  fonction Substring récupère une sous-chaîne dans expression1, avec  des caractères expression3, en commençant par la position expression2.

Syntaxe :

SubString(expression1,expression2,expression3)

Où :

  • expression1 est toujours considérée comme une chaîne ; même si elle apparaît comme une date ou un nombre, elle sera interprétée comme chaîne.

  • expression2 indique la position de départ de la sous-chaîne.

    Par exemple, 0 représente la position du premier caractère dans l'expression1, 1 représente la position du deuxième caractère, etc

  • expression3 est le nombre de caractères récupérés.

Par exemple, 3 récupère 3 caractères, 0 récupère une chaîne vide, etc.

Une valeur de –1 indique que tous les caractères jusqu’à la fin de l’expression1 doivent être récupérés.

Exemples :

SubString("abcd",1,2)=“bc”

SubString("Jacques"2,2)=“cq”

SubString(1973,0,2)=“19”

SubString("Jacques",2,-1)=“cques”

Fonction Trim

La fonction Trim permet de supprimer les espaces non significatifs devant et derrière l’expression.

Syntaxe :

Trim(expression)

Exemple :

Trim(" bonjour LE MONDE ") = “bonjour LE MONDE”

Fonction LTrim

La fonction LTrim supprime les espaces non significatifs à gauche de l’expression.

Syntaxe :

LTrim(expression)

Exemple :

LTrim(" bonjour LE MONDE ") = “bonjour LE MONDE ”

Fonction RTrim

La fonction RTrim supprime les espaces non significatifs à droite de l’expression.

Syntaxe :

RTrim(expression)

Exemple :

RTrim(" bonjour LE MONDE ") = “ bonjour LE MONDE”

Fonction Find

La fonction Find obtient l’indice de caractère (commençant par zéro) dans expression1, où se trouve la chaîne (expression2). La recherche commence à partir de l'index des caractères (expression3 – basé sur zéro). Le résultat est -1 au cas où la chaîne n’est pas trouvée.

Syntaxe :

Find(expression1, expression2, expression3)

Exemple :

Find("bonjour LE MONDE", "MONDE", 0) = 11

Fonction Replace

La  fonction Replace remplace une partie de l'expression1 commençant par l'index de caractères (expression3 – base zéro) de longueur (expression4) par la chaîne (expression2).

Syntaxe :

Replace(expression1, expression2, expression3, expression4)

Exemple :

Replace("bonjour LE MONDE", "LA TERRE", 8, 8) = “bonjour LA TERRE”

Fonction FindAndReplace

La fonction FindAndReplace remplace toutes les instances de la chaîne (expression2) dans expression1 par la chaîne (expression3).

Syntaxe :

FindAndReplace(expression1, expression2, expression3)

Exemple :

FindAndReplace("bonjour LE MONDE", "LE MONDE", "LA TERRE") = “bonjour LA TERRE”

Fonction FindAndReplaceChars

La fonction FindAndReplaceChars remplace toutes les instances d’un ou plusieurs caractères dans une chaîne par un autre ensemble de caractères. Par exemple, vous pouvez utiliser cette fonction pour remplacer des caractères URL non valides dans une chaîne.

Syntaxe :

FindAndReplaceChars(expression1, expression2, expression3)

  • expression1 - une chaîne contenant les caractères à remplacer

  • expression2 -  liste des caractères à remplacer

  • expresion3-facultative. Chaîne de remplacement à utiliser au lieu des caractères listés dans l’expression2. La chaîne peut être vide ou contenir des caractères multiples. Si la chaîne est omise, les caractères de l’expression2 sont supprimés.

Valeur de retour - la chaîne mise à jour , contenant les caractères remplacés.

Exemple :

Dans l’exemple suivant, l’espace est remplacé par un trait de soulignement ("_") :

FindAndReplaceChars("John Michael Smith", " ", "_") = "John_Michael_Smith”

Dans l’exemple suivant, l’espace est supprimé  :

FindAndReplaceChars("John Michael Smith", " ") = "JohnMichaelSmith"

Fonction FindByRegExp

La fonction FindByRegExp conserve uniquement la chaîne correspondant à la définition de l'expression régulière.  

Syntaxe des expressions régulières utilisée : grammaire ECMA-262 avec modifications.

Syntaxe

FindByRegExp(exprAsString, regExpString, firstMatchOnly)

exprAsString - Le champ de saisie auquel est appliquée l’expression régulière.

regExpString - La règle de l’expression régulière.

firstMatchOnly - Si la valeur est « False » (Faux), le système renvoie tous les résultats. Si configuré sur « True » (Vrai) - seul le premier résultat est renvoyé.

Exemple

FindByRegExp("1222 Duncan Avenue", "[A-Za-z]+",True) = Duncan

Fonction FindAndReplaceByRegExp

La fonction FindAndReplaceByRegExp recherche des motifs dans le texte à l'aide d'expressions régulières (RegExp) et les remplace par une valeur spécifiée.

Syntaxe des expressions régulières : grammaire ECMA-262 avec modifications

Syntaxe

FindAndReplaceByRegExp(exprAsString, regExpString, replaceString, firstMatchOnly)

  • exprAsString - Le champ de saisie auquel est appliquée l’expression régulière.

  • regExpString - La règle de l’expression régulière.

  • ReplaceString - la valeur pour remplacer l'expression trouvée .

  • FirstMatchOnly - si la valeur est Faux, tous les résultats sont remplacés. Vrai : seule la première correspondance est remplacée.

Exemple

FindAndReplaceByRegExp("MyFileName.Ext","\\.[^.]*$", "",False)

La fonction FindAndReplaceByRegExp("MyFileName.ext","\\,[^.]*$", "", False) utilise l'expression régulière "\\.[^.]*$" pour localiser et remplacer (par une chaîne vide) l'extension du fichier. Dans cet exemple, l'expression régulière recherche le dernier point (\\.) et tout caractère (point non compris) qui le suit ([^.]*) jusqu'à la fin de la chaîne ($). Si ce motif est trouvé, il est remplacé par une chaîne vide (supprimant ainsi l'extension).

Fonction CleanNumber

La fonction CleanNumber permet de retirer n’importe quel caractère d’une chaîne, laissant uniquement des chiffres. Ceci est particulièrement utile pour « nettoyer » des numéros de téléphone et laisser uniquement des chiffres.

Syntaxe :

CleanNumber(exprAsString)

Exemple :

L’exemple suivant supprime l’espace, et les caractères + et - de la chaîne :

CleanNumber("+1 888-452-1111") = 18884521111

Fonction CleanRecipientKey

La fonction CleanRecipientKey vous permet de traiter les caractères non valides lors de l’ajout de nouvelles clés de destinataires à la source de données (à l’aide de l’expression INSERT).

Cette fonction trouve toutes les instances de caractères URL non valides (espace, “:”, “?”, “&”, “*”, “#”, “<“, “>”, “|”, guillemets,”'”) dans l’ expression RecipientKey et les remplace par la  chaîne ReplaceInvalidWith.

Remarque : “ReplaceInvalidWith” est facultatif: Si vous ne le spécifiez pas, les caractères URL non valides dans “RecipientKey” seront supprimés.

Syntaxe :

CleanRecipientKey(RecipientKey, ReplaceInvalidWith)

Exemple :

Dans l’exemple suivant, l’espace est remplacé par un trait de soulignement ("_") :

CleanRecipientKey("John Michael.Smith", "_") = "John_Michael.Smith"

Dans l’exemple suivant, l’espace est supprimé :

CleanRecipientKey("John Michael.Smith") = "JohnMichael.Smith"

Fonction HexToUnicode

Le code hexadécimal vous permet de représenter des caractères unicode spéciaux , qui ne peuvent pas être représentés par des symboles, en utilisant leurs valeurs hexadécimales.
La  fonction HexToUnicode vous permet de traiter une chaîne hexadécimale comme une chaîne unicode.

Le paramètre d’entrée, exprChaineHexa est une chaîne de caractères hexadécimaux. Chaque séquence de quatre caractères hexadécimaux est convertie en caractère unicode correspondant (si la chaîne ne peut pas être divisée en quatre, la fonction remplit automatiquement la chaîne avec des zéros à gauche).

Il est à noter que la valeur de la chaîne d’entrée est ordonnée en gros-boutiste.

Syntaxe :

HexToUnicode(exprChaineHexa)

Exemple :

Afin d’utiliser le caractère de tabulation, vous pouvez utiliser sa valeur hexadécimale, 9, comme suit :

"Bonjour" + HexToUnicode("9") + "le Monde"

...qui aurait pour résultat :

Bonjour<Tab>le Monde

Fonction HtmlEncode

La fonction HTMLEncode(strToEncode) convertit une chaîne en chaîne codée HTML et renvoie la chaîne codée . Généralement utilisé pour encoder une URL, de façon à pouvoir publier en toute sécurité la chaîne concernée sur un serveur HTTP (c'est-à-dire dans le cadre d’un encodage d’URL).

Syntaxe

HtmlEncode(strToEncode)

Exemple :

HtmlEncode("http://my_domain/my page.html")

...qui aurait pour résultat :

"http://my_domain/my%20page.html"