ReplaceRegEx - fonction de script et fonction de graphique
ReplaceRegEx() renvoie une chaîne après avoir remplacé une ou plusieurs correspondances entre une chaîne d'entrée et un modèle d'expression régulière spécifié. Le texte qui remplace le texte correspondant est spécifié dans l'argument to_str. La fonction fonctionne de gauche à droite, mais, si vous spécifiez une valeur occurrence négative, la fonction lit de droite à gauche.
Cette fonction effectue des opérations de regex sensibles à la casse. Sinon, vous pouvez utiliser la variante ReplaceRegExI() pour effectuer des opérations de regex non sensibles à la casse.
ReplaceRegEx (text, regex, to_str [, occurrence])
chaîne
Argument | Description |
---|---|
text | Texte de chaîne d'entrée à remplacer, entièrement ou partiellement, par le nouveau texte de to_str. |
regex | Expression régulière qui détermine dans quelles conditions remplacer le texte. Les correspondances entre cet argument et l'argument text sont remplacées. |
to_str | Nouveau texte à utiliser pour remplacer le contenu existant de text. |
occurrence |
Numéro de la correspondance (entre le texte d'entrée et l'expression régulière) à remplacer par le nouveau texte. Cet argument est facultatif. S'il est omis, la valeur par défaut est 0. Lorsqu'une valeur 0 est utilisée, ou si l'argument est omis, toutes les correspondances entre text et regex sont remplacées par to_str. Vous pouvez spécifier une valeur négative pour occurrence afin d'identifier les correspondances de droite à gauche. |
Exemple | Résultat |
---|---|
ReplaceRegEx('abc123','[0-9]','x') | Renvoie abcxxx. Dans cet exemple, l'ensemble du texte de la chaîne d'entrée qui correspond au modèle de regex est remplacé par le nouveau texte. |
ReplaceRegEx('abc123','[0-9]','x',1) | Renvoie abcx23. Seule la première occurrence d'une correspondance entre la chaîne d'entrée et le modèle de regex est remplacée. |
ReplaceRegEx('abc123','[0-9]','x',4) | Renvoie abc123. Il n'existe que trois correspondances possibles entre la chaîne d'entrée et le modèle de regex, de sorte qu'aucune modification n'est effectuée. |
ReplaceRegEx('ABC123','[a-c]','5') | Renvoie ABC123. Aucune modification n'est effectuée, car ReplaceRegEx() est sensible à la casse et la variante non sensible à la casse n'est pas utilisée. |
ReplaceRegExI('ABC123','[a-c]','5') | Renvoie 555123. La variante non sensible à la casse de la fonction, ReplaceRegExI(), est utilisée. |
Cas d'utilisation
Vous pouvez utiliser ReplaceRegEx() pour modifier le texte afin de respecter les normes de formatage et de conformité, en particulier lorsqu'il existe des modèles complexes dans les données. Par exemple, vous pouvez reformater les chaînes de numéros de téléphone de sorte que seules les valeurs numériques soient incluses.
Si nécessaire, vous pouvez également utiliser cette fonction pour masquer les informations sensibles telles que les informations personnelles identifiables (PII), afin qu'elles ne soient pas affichées aux utilisateurs qui analysent votre application.