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

SubFieldRegEx - fonction de script et fonction de graphique

SubFieldRegEx() extrait le texte d'une expression de chaîne d'entrée en utilisant le modèle d'expression régulière spécifié comme délimiteur. 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 SubFieldRegExI() pour effectuer des opérations de regex non sensibles à la casse.

 

SubFieldRegEx (text, regex_delimiter [, field_no])

chaîne

Arguments
Argument Description
text Texte de chaîne d'entrée dans lequel rechercher un modèle d'expression régulière.
regex_delimiter Expression de chaîne contenant l'expression régulière à utiliser comme délimiteur. Vous pouvez spécifier plus d'un délimiteur dans le même modèle d'expression régulière en les séparant par un caractère | (barre verticale).
field_no

Valeur entière indiquant le numéro de la subdivision à extraire. Par exemple, spécifiez une valeur 4 pour extraire la quatrième sous-division. Cet argument est facultatif.

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 SubFieldRegEx() 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 SubFieldRegEx() 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
SubFieldRegEx('a,b c;1 2,3',' |,|;', 1) Renvoie a. Dans cet exemple, trois caractères de délimitation sont spécifiés (espace, virgule et point-virgule).
SubFieldRegEx('a;b;c;1;2;3',';', 2) Renvoie b. Dans ce cas, un seul caractère de délimitation est spécifié (point-virgule).
SubFieldRegEx('a,b c;1 2,3',' |,|;', 4) Renvoie 1.

Cas d'utilisation

Vous pouvez utiliser SubFieldRegEx() pour extraire plusieurs valeurs individuelles d'une liste délimitée. Par exemple, si vous disposez d'une liste séparée par des virgules contenue dans un bloc plus important de langage naturel, vous pouvez utiliser cette fonction pour isoler chaque valeur individuelle de la liste dans un nouvel enregistrement dans votre modèle de données.

Exemple 1 – Script de chargement permettant de séparer des balises par transaction

Exemple 2 – Expressions de graphique permettant de séparer les balises par transaction

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 !