Accéder au contenu principal Passer au contenu complémentaire

ExtractRegEx - fonction de script et fonction de graphique

ExtractRegEx() extrait le texte d'une expression de chaîne d'entrée en utilisant le modèle d'expression régulière spécifié. Si aucune correspondance n'est trouvée, la fonction renvoie une valeur nulle.

Cette fonction effectue des opérations de regex sensibles à la casse. Sinon, vous pouvez utiliser la variante ExtractRegExI() pour effectuer des opérations de regex non sensibles à la casse.

 

ExtractRegEx (text, regex [, field_no])

chaîne

Arguments
Argument Description
text Expression de chaîne contenant le texte à extraire dans la valeur de renvoi.
regex Expression régulière à utiliser pour extraire le texte.
field_no

Numéro de la correspondance à extraire. Cela s'avère utile lorsqu'il est possible de trouver plusieurs correspondances pour l'expression régulière dans le texte. Par exemple, spécifiez une valeur 4 pour extraire la quatrième correspondance. Cet argument est facultatif. Spécifiez une valeur négative pour inverser l'ordre des correspondances.

Les règles suivantes s'appliquent, que la fonction soit utilisée dans un script de chargement ou dans une expression de graphique :

  • Si field_no est positif, la fonction renvoie une valeur, identifiant les correspondances de gauche à droite.

  • Si field_no est négatif, la fonction renvoie une valeur, identifiant les correspondances de droite à gauche.

Lors de l'utilisation de la fonction dans un script de chargement :

  • Si vous utilisez la fonction ExtractRegEx() dans une instruction LOAD et si field_no est omis, la fonction génère autant d'enregistrements qu'il existe de correspondances.

  • Si plusieurs champs sont chargés à l'aide de ExtractRegEx() et si aucun d'entre eux ne spécifie un argument field_no, les produits cartésiens de toutes les combinaisons sont créés.

Lors de l'utilisation de la fonction dans une expression de graphique :

  • Si field_no est omis, la valeur par défaut est 1.

Exemples de fonction
Exemple Résultat
ExtractRegEx('a,b c;1 2,3','[a-z]|[0-9]', 1) Renvoie a, qui est la première correspondance trouvée.
ExtractRegEx('a,b c;1 2,3','[a-z]|[0-9]', 2) Renvoie b, qui est la deuxième correspondance trouvée.
ExtractRegEx('a,b c;1 2,3','[a-z]|[0-9]', 4) Renvoie 1, qui est la quatrième correspondance trouvée.
ExtractRegEx('abc','a|b',-1) Renvoie b. Lorsqu'une valeur négative est spécifiée, les correspondances sont comptées en sens inverse.
ExtractRegEx('A,B C;1 2,3','[a-c]|[4-9]') Renvoie une valeur nulle, car ExtractRegEx() est sensible à la casse et la variante non sensible à la casse n'a pas été utilisée.
ExtractRegExI('A,B C;1 2,3','[a-c]|[4-9]') Renvoie A, car la variante non sensible à la casse ExtractRegExI() a été utilisée.

Cas d'utilisation

Vous pouvez utiliser Extract RegEx() pour extraire des informations à isoler de données pouvant également contenir d'autres informations (par exemple, un texte libre ou des chaînes JSON). Par exemple :

  • Extraire d'un texte des adresses e-mail, des numéros de téléphone, des numéros de compte et d'autres informations.

  • Extraire d'un texte des valeurs numériques (par exemple, des devises).

  • Normaliser le formatage de données textuelles ou numériques.

Exemple 1 – Script de chargement permettant d'extraire des adresses e-mail de chaînes JSON

Exemple 2 – Script de chargement permettant d'extraire des valeurs numériques de montants en devises

Exemple 3 – Expressions de graphique permettant d'extraire des adresses e-mail de chaînes JSON

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – dites-nous comment nous améliorer !