Une fonction chaîne exécute des opérations sur des données de texte. Utilisez une fonction chaîne pour nettoyer les données, convertir des données dans un autre format ou casse, calculer des métriques relatives aux données ou effectuer d’autres manipulations. Utilisez les fonctions chaîne avec des types de données chaîne uniquement.
Contains (String, Target, CaseInsensitive = 1)
: recherche l'occurrence d'une chaîne particulière dans une chaîne. Renvoie la valeur vraie si la chaîne (String) contient la chaîne cible (Target), sinon renvoie la valeur fausse.
Contains('123ABC', 'ABC')
renvoie True (Vrai).
Contains('123ABC', 'abc')
renvoie True (Vrai).
Contains('123ABC', 'abc', 0)
renvoie False (Faux).
CountWords(string)
: renvoie le nombre de mots dans la chaîne spécifiée. Les mots sont définis comme des ensembles de caractères séparés par un espace.
CountWords("Basic Variables Households")
renvoie 3.
CountWords("Basic Variables Age:Female (Pop)Age 1")
renvoie 5.
DecomposeUnicodeForMatch(String)
: retire les accents et développe les caractères composés pendant la conversion en chaîne étroite. Cette fonction prend un type de données
WString
d'Alteryx et le convertit en un type de données
String
étroit avec des lettres minuscules. Tous les accents et similaires sont enlevés. Reportez-vous à la section
Types de données
pour plus d'informations sur les types de données Alteryx.
Important
Cette fonction n’est utile que pour les opérations de concordance. Son résultat n’est pas considéré comme une chaîne normalisée.
La fonction n'est pas conçue pour être utilisée avec des jeux de caractères non occidentaux comme le japonais. Vous devriez éviter d'utiliser cette fonction dans des chaînes qui peuvent contenir des caractères étendus. Sachez que les caractères étendus sont convertis en « ? ».
DecomposeUnicodeForMatch("Prénoms français")
renvoie les prénoms français.
EndsWith(String, Target, CaseInsensitive=1)
: vérifie si une chaîne se termine par une chaîne particulière. Renvoie True si la chaîne (String) se termine par la chaîne cible (Target), sinon renvoie False. Par défaut, il est insensible à la casse.
EndsWith('123ABC', 'ABC')
renvoie True (Vrai).
EndsWith('123ABC', 'abc')
renvoie True (Vrai).
EndsWith('123ABC', 'abc', 0)
renvoie False (Faux).
FindNth(Initial String, Target, Instance)
: recherche l'instance (la Nième occurrence) de la cible dans la chaîne initiale et renvoie la position indexée 0 de l'instance. Cette fonction est sensible à la casse et ne prend pas en charge les paramètres négatifs.
FindNth("Hello World","o",2)
renvoie 7. La fonction recherche la 2e instance de « o » dans la chaîne fournie et renvoie la position indexée 0, en l'occurrence 7.
FindNth("Hello World","World",1)
renvoie 6. La fonction recherche la 1re instance de « World » dans la chaîne fournie et renvoie la position indexée 0 du premier caractère, en l'occurrence 6.
FindNth("Hello World","o",1.8)
renvoie 7. La fonction recherche la 2e instance (arrondissement de 1.8 à l'entier le plus proche) de « o » dans la chaîne fournie et renvoie la position indexée 0 du 2e caractère, en l'occurrence 7.
FindNth("Hello World","world",1)
renvoie -1. La fonction recherche la 1re instance de « world » dans la chaîne fournie et renvoie la position indexée 0 du premier caractère, en l'occurrence -1 (aucune correspondance en raison de la sensibilité à la casse).
FindNth("Hello World","l",0)
renvoie -1. La fonction recherche la 0e instance de « l » dans la chaîne fournie et renvoie la position indexée 0, en l'occurrence -1 (introuvable, car la 0e position n'existe pas).
FindNth("Hello World","l",-1)
renvoie -1. Dans la mesure où les paramètres négatifs ne sont pas applicables, la fonction renvoie -1 (introuvable).
FindNth("Hello World", Null(), 1)
renvoie -1. Les valeurs nulles et vides sont introuvables.
FindNth(Hello world, "l", 1)
renvoie une erreur. La fonction exige que les 2 premiers paramètres soient des chaînes.
Important
La fonction
FindString
est sensible à la casse.
FindString(String, Target)
: recherche l'occurrence d'une chaîne particulière (Target) dans une autre chaîne (String) et renvoie la position numérique de son occurrence dans la chaîne.
Renvoie l’index de base 0 de la première occurrence de la cible (Target) dans la chaîne (String). Renvoie -1 en l'absence d'occurrence.
FindString([Name], "John") returns the 0-based index position of the first character of the target string if the provided string contains the target and returns -1 when the string does not.
FindString("John Smith", "John")returns 0. The first character ("J") of the target string "John" is in the 0 position of "John Smith."FindString("Michael John Smith", "John")returns 8. The first character ("J") of the target string "John" is in the 8 position (0-based index) of "Michael John Smith."FindString("David Smith", "John")returns -1. The target string "John" is not found in the string "David Smith."
GetLeft(String, Delimiter)
: renvoie la partie gauche de la chaîne fournie jusqu'à la première instance du ou des délimiteurs spécifiés.
Opérateur Délimiteur
Remarque : l'opérateur
Délimiteur
est sensible à la casse. Si vous spécifiez « a » comme délimiteur, la fonction utilise uniquement « a » comme délimiteur, et non « A ».
GetLeft("Automated Analytics for All", " ")
renvoie « Automated ».
GetLeft("Enable fast, confident decisions across the enterprise.", ",")
renvoie « Enable fast ».
GetLeft("Automated Analytics for All", "for") returns "Aut".
While you might expect the return to be "Automated Analytics ", this is not the case.
"for" is treated as 3 separate delimiters "f", "o", and "r". Alteryx searches for the first occurrence of any of the characters in "for" in the provided string. In the above example:
"f" is the 21st character.
"o" is the 4th character. Since "o" appears first in the string, the string is split at this character.
"f" is the 23rd character.
It's important to note that the delimiter is case-sensitive. A slight modification to the above example can illustrate this:
GetLeft("Automated Analytics for All", "fOr")returns "Automated Analytics "."f" is the 21st character. Since "f" appears first in the string. The string is split at this character.
"O" does not occur in the string. Note that this is a capital "O".
"r" is the 23rd character.
GetPart(String, Delimiter, Index)
: utilise le ou les délimiteurs spécifiés pour diviser la chaîne en sous-chaînes et renvoie la sous-chaîne à la position indiquée dans l'index.
Opérateur Délimiteur
Remarque : l'opérateur
Délimiteur
est sensible à la casse. Si vous spécifiez « a » comme délimiteur, la fonction utilise uniquement « a » comme délimiteur, et non « A ».
Cette fonction utilise un index en base 0. Par exemple, si Index est égal à 2, la fonction renvoie la chaîne à partir de la position dans index 2, qui est la troisième sous-chaîne.
GetPart("Automated Analytics for All", " ", 1)
renvoie « Analytics ».
GetPart("Automated Analytics for All", " ", 0)
renvoie « Automated ».
GetPart("Enable fast, confident decisions across the enterprise.", ", ", 5)
renvoie « across ». Notez que cet exemple utilise 2 délimiteurs : une virgule et un espace. La fonction divise la chaîne lorsqu'elle rencontre l'un ou l'autre des délimiteurs.
GetPart("January 1, 2023", " ", 2)
renvoie « 2023 ».
GetRight(String, Delimiter)
: renvoie la partie droite de la chaîne fournie après la première instance du ou des délimiteurs spécifiés.
Opérateur Délimiteur
Remarque : l'opérateur
Délimiteur
est sensible à la casse. Si vous spécifiez « a » comme délimiteur, la fonction utilise uniquement « a » comme délimiteur, et non « A ».
GetRight("Automated Analytics for All", " ")
renvoie « Analytics for All ».
GetRight("Enable fast, confident decisions across the enterprise.", ",")
renvoie « confident decisions across the enterprise. » (notez l'espace avant
confident
dans la valeur renvoyée).
GetRight("Automated Analytics for All", "for") returns "mated Analytics for All".
While you might expect the return to be "All", this is not the case.
"for" is treated as 3 separate delimiters "f", "o", and "r". Alteryx searches for the first occurrence of any of the characters in "for" in the provided string. In the above example:
"f" is the 21st character.
"o" is the 4th character. Since "o" appears first in the string, the string is split at this character.
"r" is the 23rd character.
It's important to note that the delimiter is case-sensitive. A slight modification to the above example can illustrate this:
GetRight("Automated Analytics for All", "fOr")returns " or All"."f" is the 21st character. Since "f" appears first in the string. The string is split at this character.
"O" does not occur in the string. Note that this is a capital "O".
"r" is the 23rd character.
GetWord(string, n)
: renvoie le Nième mot (base 0) de la chaîne (l'index en base 0 signifie que le premier mot se trouve à la position 0, le second à la position 1, et ainsi de suite). Les mots sont définis comme un ensemble de caractères séparés par un espace, une tabulation, un retour ou un saut de ligne. Plusieurs délimiteurs consécutifs sont traités comme un seul délimiteur.
GetWord("Basic Variables Households", 0)
renvoie « Basic ».
GetWord("Basic Variables Households", 1)
renvoie « Variables ».
Left(String, len)
: renvoie les premiers caractères (len) de la chaîne (String). Si len est inférieur à 0 ou supérieur à la longueur de la chaîne (String), la chaîne reste inchangée.
Left("92688", 3)
renvoie la valeur « 926 ».
Length(String)
: renvoie la longueur de la chaîne (String).
Avertissement
Les résultats de longueur peuvent différer entre cette fonction Designer et les fonctions SQL. Tout dépend de la façon dont une base de données particulière traite les caractères étendus et les sauts de ligne. Par exemple, les caractères de nouvelle ligne sont pris en compte dans la fonction Longueur de PostgreSQL, alors qu'ils ne le sont pas dans la fonction Longueur de Designer, et les résultats dans Designer peuvent différer selon que le pilote ANSI ou Unicode est utilisé.
Length("92688")
renvoie la valeur 5.
LowerCase(String)
: convertit une chaîne en minuscules.
LowerCase("M1P 1G6")
renvoie « m1p 1g6 ».
MD5_ASCII(String)
: calcule le hachage MD5 de la chaîne. La chaîne ne devrait comporter que des caractères étroits. Les caractères étendus sont convertis en « ? » avant de calculer le hachage. À utiliser pour les types de données String, déconseillé pour les types de données WString. Vous devez éviter d'utiliser cette fonction sur des chaînes pouvant contenir des caractères étendus.
MD5_UNICODE(String)
: pour le moteur d'origine et l'AMP, calcule le hachage MD5 de la chaîne stockée avec le codage UTF-16.
MD5_UTF8(String)
: calcule le hachage MD5 de la chaîne stockée avec le codage UTF-8.
Md5_Ascii("Lá")
, stocké en Latin1, occupe 2 octets, 4C E1. La fonction calcule le hachage MD5 des octets, donnant le résultat « 0c0ee86cc87d87125ad8923562be952e ».
Md5_Ascii("Lá ☢")
, le caractère ☢ étendu est remplacé par un « ? », c'est donc comme si vous calculiez Md5_Ascii("Lá?"). Il est stocké en Latin1 sur 3 octets, 4C E1 3F. La fonction calcule le hachage MD5 des octets, donnant le résultat « a5a308ab19acf900efea8fc7b5b77b4d »
Md5_Unicode("Lá")
, stocké en UTF-16, occupe 4 octets, 4C 00 E1 00. La fonction calcule le MD5 des octets, donnant le résultat « aa9969dfcca04249842cc457e5b3dd01 ».
Md5_Unicode("Lá ☢")
, lorsqu'il est stocké en UTF-16, occupe 8 octets, 4C 00 E1 00 3C D8 C8 DF. La fonction calcule le hachage MD5 des octets, donnant le résultat « 7c4762d93572dd02a8a405232e966b18 »
Md5_Utf8("Lá")
, stocké en UTF-8, occupe 3 octets, 4C C3 A1. La fonction calcule le MD5 des octets, donnant le résultat « 68f00289dc3be140b1dfd4e031d733f1 ».
Md5_Utf8("Lá ☢")
, lorsqu'il est stocké en UTF-8, occupe 7 octets, 4C C3 A1 F0 9F 8F 88. La fonction calcule le hachage MD5 des octets, donnant le résultat « 383fc0355db728a2078ce41a2ab6211b »
PadLeft (String, len, char)
: remplit le côté gauche de la chaîne (chaîne) avec le caractère spécifié jusqu’à la longueur spécifiée. Si le remplissage (char) est supérieur à un caractère, seul le premier caractère est utilisé.
PadLeft("M", 4, "x")
renvoie « xxxM ».
PadRight (String, len, char)
: remplit le côté droit de la chaîne (String) avec le caractère spécifié jusqu’à la longueur spécifiée. Si le remplissage (char) est supérieur à un caractère, seul le premier caractère est utilisé.
PadRight("M", 4, "x")
renvoie « Mxxx ».
REGEX_CountMatches(String,pattern,icase)
: renvoie le nombre de concordances dans la chaîne (String) avec le modèle.
icase
est un paramètre facultatif. S’il est spécifié, la casse doit concorder. Par défaut, icase=1 (signifie que la casse est ignorée). S’il est défini sur 0, la casse doit concorder.
REGEX_Match(String,pattern,icase)
: recherche une occurrence d'une expression régulière dans une chaîne.
Indique si la chaîne concorde avec le schéma du premier caractère jusqu’à la fin.
Pour rechercher un élément qui ne commence pas nécessairement au début de la chaîne, commencez le schéma par « .* ».
Pour rechercher un élément qui ne s’arrête pas nécessairement à la fin de la chaîne, terminez le schéma par « .* ».
icase
est un paramètre facultatif. S’il est spécifié, la casse doit concorder. Par défaut, icase=1 (signifie que la casse est ignorée). S’il est défini sur 0, la casse doit concorder.
REGEX_Match("123-45-6789", "\d{3}-\d{2}-\d{4}")
renvoie -1 (Vrai).
REGEX_Replace(String, pattern, replace, icase)
: permet de remplacer du texte en utilisant des expressions régulières et renvoie la chaîne résultant des fonctions RegEx rechercher (pattern) et remplacer (string). Toutes les occurrences de la concordance sont remplacées, pas seulement la première.
Le paramètre de remplacement peut être une valeur spécifiée (comme indiqué ci-dessous) ou un groupe marqué, par exemple « $1 ». Assurez-vous de placer les groupes marqués entre guillemets doubles.
icase
est un paramètre facultatif. S’il est spécifié, la casse doit concorder.
Par défaut, icase=1 signifie que la casse est ignorée.
S’il est défini sur 0, la casse doit concorder.
REGEX_Replace("Don't reveal your Social Security number, 123-45-6789","\d{3}-\d{2}-\d{4}", "CLASSIFIED")
renvoie « Don't reveal your Social Security number, CLASSIFIED ».
REGEX_Replace("Change all domain names from alteryx@Alteryx.com","@.*\.", "@extendthereach.")
renvoie « Change all domain names from alteryx@extendthereach.com ».
REGEX_Replace("25 test","(\d+)\s.*","$1")
renvoie 25.
Replace(String, Target, Replacement)
: retourne la chaîne (String) après avoir remplacé chaque occurrence de la chaîne (Target) par la chaîne (Replacement).
Replace("Good judgment comes from experience", "experience", "awareness")
renvoie « Good judgment comes from awareness ».
ReplaceChar(String, y, z)
: renvoie la chaîne (String) après le remplacement de chaque occurrence du caractère (y) par le caractère (z). Si le caractère de remplacement (z) est une chaîne comportant plusieurs caractères, seul le premier caractère est utilisé. Si (z) est vide, chaque caractère (String) qui correspond à n’importe quel caractère dans (y) est simplement supprimé.
ReplaceChar("abcdefb", "b", "_")
renvoie « a_cdef_ ».
ReplaceChar("@a#b%c", "@,#,%", "_")
renvoie « _a_b_c ».
ReplaceFirst(String, Target, Replacement)
: renvoie la chaîne (String) après le remplacement de la première occurrence de la chaîne (Target) par la chaîne de remplacement (Replacement).
ReplaceFirst("abcdefb", "b", "_")
renvoie « a_cdefb ».
ReverseString(String)
: inverse tous les caractères de la chaîne.
ReverseString("abcdefb")
renvoie « bfedcba ».
Right(String, Len)
: retourne les derniers caractères (Len) de la chaîne. Si len est inférieur à 0 ou supérieur à la longueur de String, la chaîne reste inchangée.
Right("92688", 3)
renvoie la valeur « 688 ».
StartsWith(String, Target, CaseInsensitive=1)
: vérifie si une chaîne commence par une chaîne particulière. Renvoie la valeur vraie si la chaîne commence par une chaîne cible (Target) spécifique, sinon renvoie la valeur fausse.
StartsWith('ABC123', 'ABC')
renvoie True (Vrai).
StartsWith('ABC123', 'abc')
renvoie True (Vrai).
StartsWith('ABC123', 'abc', 0)
renvoie False (Faux).
STRCSPN(String, y)
: renvoie la longueur du segment initial de la chaîne (String) composé de caractères qui
ne
sont pas dans la chaîne (y).
STRCSPN("Bob's Amaco", "~!@#$%^&*'()")
renvoie 3. Cette fonction est utile pour contrôler l’absence de ponctuation dans la chaîne.
StripQuotes(String)
: supprime les jeux de guillemets ou apostrophes des extrémités de la chaîne.
StripQuotes("Hello there")
renvoie Hello there.
StripQuotes("'Hello there,' she said.")
renvoie 'Hello there,' she said.
StripQuotes('"Hello there," she said.')
renvoie "Hello there," she said.
STRSPN(String, y)
: renvoie la longueur du segment initial de la chaîne (String) composé de caractères de la chaîne (y).
STRSPN("3034408896x105", "0123456789")
renvoie 10. Ceci est un test utile pour s’assurer qu’une chaîne est formée par un ensemble de caractères.
Substring(String, start, length)
: retourne la sous-chaîne de la chaîne (String), en commençant par (start) et en s’arrêtant après la longueur indiquée par (lenght), si elle est fournie.
Substring("949-222-4356", 4, 8)
renvoie « 222-4356 ».
Substring("949-222-4356", 4, 6)
renvoie « 222-43 ».
Substring("949-222-4356", 4)
renvoie « 222-4356 ».
TitleCase(String)
: convertit la chaîne en majuscules.
TitleCase("john smith")
renvoie "John Smith".
Trim(String, y)
: supprime le(s) caractère(s) de la chaîne (y) du début et de la fin de la chaîne (String). Y est optionnel, et par défaut, cette fonction supprime les espaces vides. Notez dans les exemples de la fonction TRIM que les caractères spécifiés sont supprimés. L’ordre des caractères n’a pas d’importance.
Trim("!see instructions!!!", "!")
renvoie "see instructions".
Trim(" Test123 ")
renvoie "Test123".
TrimLeft(String, y)
: supprime les caractères de la chaîne (y) du début de la chaîne (String). Y est optionnel, et par défaut, cette fonction supprime les espaces vides.
TrimLeft("** special invitation ", " *")
renvoie "special invitation ".
TrimRight(String, y)
: supprime les caractères de la chaîne (y) de la fin de la chaîne (String). Y est optionnel, et par défaut, cette fonction supprime les espaces vides.
Même si vous indiquez une chaîne de caractères à supprimer, la fonction TRIM ne respecte pas l’ordre des caractères et traite la chaîne plutôt comme une liste. Elle coupe donc TOUS les caractères spécifiés de la liste. Si vous cherchez à remplacer une chaîne, utilisez une fonction REPLACE ou REGEX dans votre expression.
TrimRight("John Smith ")
renvoie "John Smith".
TrimRight("John Smith**","*")
renvoie "John Smith".
Uppercase(String)
:convertit la chaîne (String) en lettres majuscules
Uppercase("John Smith")
renvoie "JOHN SMITH".
UuidCreate()
: crée un identifiant unique.
UuidCreate()
renvoie une valeur unique telle que ba131836-1ba3-4d42-8f7e-b81a99c2e838.
En faisant référence à la longueur length d'une chaîne (String), le premier caractère est compté pour 1 (la longueur de la chaîne « enregistrement » est 14).
Cependant, lors du référencement de la position des caractères dans une chaîne, les positions sont comptées entre les caractères. La position du premier caractère est alors considérée comme 0. Par conséquent, la lettre « r » dans la chaîne enregistrement est à la position 2.