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

ReplaceRegExGroup - fonction de script et fonction de graphique

ReplaceRegExGroup() renvoie une chaîne après avoir remplacé une ou plusieurs correspondances entre une chaîne d'entrée et le modèle d'expression régulière composite 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 ReplaceRegExGroupI() pour effectuer des opérations de regex non sensibles à la casse.

 

ReplaceRegExGroup (text, regex, to_str, group [, occurrence])

chaîne

Arguments
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.
group

Numéro du groupe, dans le cas d'une expression régulière composite.

Si l'expression régulière ne contient qu'un seul groupe, utilisez plutôt la fonction ReplaceRegEx(). Sinon, utilisez ReplaceRegExGroup() avec une valeur group égale à 0.

Vous pouvez spécifier une valeur group négative pour rechercher des groupes de droite à gauche.

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.

Exemples de fonction
Exemple Résultat
ReplaceRegExGroup('abc123','([a-z])([0-9]+)','x',0) Renvoie abx (remplace la correspondance complète).
ReplaceRegExGroup('abc123','([a-z])([0-9]+)','x',1) Renvoie abx123 (ne remplace que le premier groupe de la correspondance).
ReplaceRegExGroup('abc123','([a-z])([0-9]+)','x',2) Renvoie abcx (ne remplace que le deuxième groupe de la correspondance).
ReplaceRegExGroup('abc123abc123','([a-z])([0-9]+)','x',1,2) Renvoie abc123abx123. Il existe deux correspondances entre le premier groupe du texte d'entrée et le modèle de regex. Toutefois, seule la deuxième occurrence est remplacée.
ReplaceRegExGroup('ABC123ABC123','([a-z])([0-9]+)','x',1) Renvoie ABC123ABC123. En d'autres termes, aucun texte n'est remplacé. Cela est dû au fait que la fonction est sensible à la casse et que la variante non sensible à la casse de la fonction n'est pas utilisée.
ReplaceRegExGroupI('ABC123ABC123','([a-z])([0-9]+)','x',1) Renvoie ABx123ABx123. Dans cet exemple, le texte est remplacé, car la variante non sensible à la casse de la fonction, ReplaceRegExGroupI(), est utilisée.

Cas d'utilisation

Vous pouvez utiliser ReplaceRegExGroup() pour modifier le texte afin de respecter les normes de formatage et de conformité, en particulier lorsque vous devez identifier des modèles complexes dans les données. L'argument group supplémentaire de cette fonction vous permet de ne mettre à jour que certaines portions d'un modèle de texte plus grand. Par exemple, vous pouvez mettre à jour des parties spécifiques d'une URL.

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.

Exemple 1 – Script de chargement permettant de mettre à jour le domaine dans des URL

Exemple 2 – Expression de graphique permettant de mettre à jour le protocole des URL

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 !