IsMatch, Matchet MatchAll fonctions

S’applique à : Applications Canevas Copilot Studio Basées sur des modèles , applications Power Platform CLI Dataverse fonctions Power Pages

Teste une correspondance ou extrait des parties d’une chaîne de texte en fonction d’un modèle.

Description

La IsMatch fonction teste si une chaîne de texte correspond à un modèle qui peut comprendre des caractères ordinaires, des modèles prédéfinis ou une expression régulière. Les Match fonctions retournent MatchAll ce qui a été mis en correspondance, y compris les sous-correspondances.

Permet IsMatch de valider ce qu’un utilisateur a tapé dans un contrôle d’entrée de texte . Par exemple, vérifiez si l’utilisateur a entré une adresse e-mail valide avant l’enregistrement du résultat dans votre source de données. Si l’entrée ne correspond pas à vos critères, ajoutez d’autres contrôles qui invitent l’utilisateur à corriger l’entrée.

Permet Match d’extraire la première chaîne de texte qui correspond à un modèle et MatchAll d’extraire toutes les chaînes de texte qui correspondent. Extrayez les sous-correspondances pour analyser des chaînes complexes.

Match retourne un enregistrement d’informations pour la première correspondance trouvée et MatchAll retourne une table d’enregistrements pour chaque correspondance trouvée. Le ou les enregistrements contiennent :

Ces fonctions prennent en charge MatchOptions. Par défaut :

• Ces fonctions effectuent une correspondance sensible à la casse. Utilisez MatchOptions.IgnoreCase pour effectuer des correspondances insensibles à la casse.
• IsMatch correspond à l’intégralité de la chaîne de texte (Complete MatchOption), tandis que vous MatchMatchAll recherchez une correspondance n’importe où dans la chaîne de texte (Contains MatchOption). Utilisez Complete, Contains, BeginsWith, ou EndsWith selon votre scénario.

IsMatch retourne true si la chaîne de texte correspond au modèle ou false si ce n’est pas le cas. Match retourne vide si aucune correspondance n’est trouvée qui peut être testée avec la fonction IsBlank . MatchAll retourne une table vide si aucune correspondance n’est trouvée qui peut être testée avec la fonction IsEmpty .

Si vous utilisez MatchAll pour fractionner une chaîne de texte, envisagez d’utiliser la fonction Split , ce qui est plus simple et plus rapide.

Modèles

L’utilisation de ces fonctions repose principalement sur la description du modèle à mettre en correspondance. Vous devez décrire le modèle dans une chaîne de texte en combinant les éléments suivants :

• Caractères ordinaires, tels que « abc » ou « 123 ».
• Modèles prédéfinis, comme Letter, MultipleDigits ou Email. (L’énumération Match définit ces modèles.)
• Codes d’expressions régulières, comme "\d+\s+\d+" ou "[a-z]+".

Combinez ces éléments à l’aide de l’opérateur de concaténation de chaîne &. Par exemple, le "abc" & Digit & "\s+" est un modèle valide qui correspond aux caractères « a », « b » et « c », suivis d’un chiffre compris entre 0 et 9, puis d’au moins un espace blanc.

Caractères ordinaires

Le modèle le plus simple est une séquence de caractères ordinaires qui correspondent exactement.

Par exemple, lorsqu’elle est utilisée avec la IsMatch fonction, la chaîne « Hello » correspond exactement au modèle « Hello ». Ni plus ni moins. La chaîne "hello!" ne correspond pas au modèle en raison du point d’exclamation à la fin et parce que le cas est incorrect pour la lettre « h ». (Consultez Match les options permettant de modifier ce comportement.)

Dans la langue du modèle, les caractères . ? * + ( ) [ ] ^ $ | \ sont réservés à des fins spéciales. Pour utiliser ces caractères, préfixez le caractère avec une \ (barre oblique inverse) pour indiquer que le caractère doit être pris littéralement, ou utilisez l’un des modèles prédéfinis. Par exemple, vous pouvez faire correspondre la chaîne "Hello?" à l’aide du modèle "Hello\\?" avec une barre oblique inverse avant le point d’interrogation.

Modèles prédéfinis

Les modèles prédéfinis offrent un moyen simple de faire correspondre un caractère d’un jeu de caractères ou une séquence de caractères. Utilisez l’opérateur de concaténation de chaînes & pour combiner vos propres chaînes de texte avec les membres de l’énumération Match :

Par exemple, le modèle « A » & MultipleDigits correspond à la lettre « A » suivie d’un ou plusieurs chiffres.

Power Apps utilise une définition différente pour Match. EMail et Match. Trait d’union. Évaluez Text( Match.Email ) l’expression régulière utilisée par votre hôte.

Expressions régulières

Le modèle utilisé par ces fonctions est appelé expression régulière. Le dialecte spécifique de Power Fx des expressions régulières est détaillé dans les expressions régulières dans Power Fx.

Les expressions régulières sont puissantes et servent un large éventail d’objectifs. Ils peuvent également ressembler à une séquence aléatoire de marques de ponctuation. Cet article ne décrit pas tous les aspects des expressions régulières, mais une grande quantité d’informations, de didacticiels et d’outils est disponible en ligne.

Les expressions régulières ont une longue histoire et sont disponibles dans de nombreux langages de programmation. Chaque langage de programmation a son propre dialecte d’expressions régulières, et il existe peu de normes. Nous nous efforçons de garantir que la même expression régulière donne le même résultat dans toutes les implémentations Power Fx. La compatibilité n’est pas facile à réaliser car Power Fx s’exécute sur JavaScript et .NET qui présentent des différences significatives. Pour s’adapter à l’exécution sur différentes plateformes, les expressions régulières Power Fx sont limitées à un sous-ensemble de fonctionnalités largement prises en charge dans l’ensemble du secteur.

Par conséquent, certaines expressions régulières qui peuvent fonctionner dans d’autres environnements peuvent être bloquées ou nécessiter un ajustement dans Power Fx. Des erreurs au moment de la création sont signalées lorsque des fonctionnalités non prises en charge sont rencontrées. Il s’agit de l’une des raisons pour lesquelles l’expression régulière et les options doivent être une constante de temps de création et non dynamique (par exemple, fournie dans une variable).

Voici quelques éléments de base des expressions régulières qui créent une complexité dans l’analyse d’un nombre.

Ces exemples donnent uniquement un petit goût de ce que les expressions régulières peuvent faire. Ils sont couramment utilisés pour valider les numéros d’ID, les adresses e-mail, les numéros de téléphone, les dates et les heures, et pour extraire des informations de tous types de fichiers texte. Poursuivez votre parcours en lisant des expressions régulières dans Power Fx, expérimentez et utilisez le web pour en savoir plus.

Options Match

Modifiez le comportement de ces fonctions en spécifiant une ou plusieurs options, que vous combinez à l’aide de l’opérateur de concaténation de chaîne (&).

L’utilisation MatchAll est identique à l’utilisation du modificateur « g » standard pour les expressions régulières.

Syntaxe

IsMatch( Texte, Modèle [, Options ] )

• Texte – Obligatoire. La chaîne de texte à tester.
• Motif – Obligatoire. Le modèle à tester, comme une chaîne de texte. Concaténer des modèles prédéfinis que l’énumération Match définit ou fournit une expression régulière. Le modèle doit être une formule constante sans variables, sources de données ou autres références dynamiques qui changent à mesure que l’application s’exécute. Notez que la formule doit être exprimée sous la forme «Match . PrédéfiniPattern " par exemple Match. Messagerie électronique
• Options – Facultatif. Une combinaison de valeurs enum MatchOptions dans une chaîne de texte. Par défaut, MatchOptions.Complete est utilisé. Les options doivent être une formule constante sans variables, sources de données ou autres références dynamiques qui changent à mesure que l’application s’exécute.

Match( Texte, Modèle [, Options ] )

• Texte – Obligatoire. La chaîne de texte à mettre en correspondance.
• Motif – Obligatoire. Le modèle à mettre en correspondance, comme une chaîne de texte. Concaténer des modèles prédéfinis définis par l’énumération Match ou fournir une expression régulière. Le modèle doit être une formule constante sans aucune variable, source de données ou autre référence dynamique qui change au fur et à mesure de l’exécution de l’application.
• Options – Facultatif. Une combinaison de valeurs enum MatchOptions dans une chaîne de texte. Par défaut, MatchOptions.Contains est utilisé. Les options doivent être une formule constante sans variables, sources de données ou autres références dynamiques qui changent à mesure que l’application s’exécute.

MatchAll( Texte, Modèle [, Options ] )

• Texte – Obligatoire. La chaîne de texte à mettre en correspondance.
• Motif – Obligatoire. Le modèle à mettre en correspondance, comme une chaîne de texte. Concaténer des modèles prédéfinis que l’énumération Match définit ou fournit une expression régulière. Le modèle doit être une formule constante sans variables, sources de données ou autres références dynamiques qui changent à mesure que l’application s’exécute.
• Options – Facultatif. Une combinaison de valeurs enum MatchOptions dans une chaîne de texte. Par défaut, MatchOptions.Contains est utilisé. Les options doivent être une formule constante sans variables, sources de données ou autres références dynamiques qui changent à mesure que l’application s’exécute.

IsMatch Exemples

Caractères ordinaires

Imaginez que votre application dispose d’un contrôle d’entrée de texte nommé TextInput1. Les utilisateurs entrent des valeurs dans ce contrôle pour les stocker dans une base de données.

Les utilisateurs tapez Hello world dans TextInput1.

Modèles prédéfinis

Expressions régulières

Match et MatchAll exemples

Examinons ce dernier exemple. Si vous souhaitez convertir cette chaîne en valeur de date/heure à l’aide de la fonction Time , vous devez passer individuellement les sous-correspondances nommées. Pour ce faire, utilisez la fonction With qui fonctionne sur l’enregistrement qui Match retourne :

With(
    Match( "PT2H1M39S", "PT(?:(?<hours>\d+)H)?(?:(?<minutes>\d+)M)?(?:(?<seconds>\d+)S)?" ),
   Time( Value( hours ), Value( minutes ), Value( seconds ) )
)

Pour ces exemples, ajoutez un contrôle Button, définissez sa propriété OnSelect sur cette formule, puis sélectionnez le bouton :

Set( pangram, "The quick brown fox jumps over the lazy dog." )

Formule	Description	Résultat
Match( pangram, "THE", IgnoreCase )	Trouvez toutes les correspondances de "THE" dans la chaîne de texte que la variable pangram contient. La chaîne contient deux correspondances, mais seule la première est retournée, car vous utilisez Match et non MatchAll.	{ FullMatch : « The », StartMatch : 32 }
MatchAll( pangram, "the" )	Trouvez toutes les correspondances de "the" dans la chaîne de texte que la variable pangram contient. Le test est sensible à la casse, donc seule la deuxième instance de "the" est trouvée.
MatchAll( pangram, "the", IgnoreCase )	Trouvez toutes les correspondances de "the" dans la chaîne de texte que la variable pangram contient. Dans ce cas, le test est insensible à la casse, donc les deux instances du mot sont trouvées.
MatchAll( pangram, "\b\wo\w\b" )	Recherche tous les mots de trois lettres avec un "o" au milieu. « brown » est exclu car il n’est pas un mot à trois lettres et, par conséquent, ne correspond pas à « \b » (limite de mot).
Match( pangram, "\b\wo\w\b\s\*(?<between>\w.+\w)\s\*\b\wo\w\b" )	Correspond à tous les caractères entre "fox" et "dog".	{ entre : « saute au-dessus du paresseux », FullMatch : « fox saute sur le chien paresseux », StartMatch : 17 }

Pour afficher les résultats d’une MatchAll galerie :

1. Dans un écran vide, insérez un contrôle de galerie verticale vide.

2. Définissez la propriété MatchAllItems de la galerie sur ( pangram, « \w+ » ) ou MatchAll( pangram, MultipleLetters ).

   

3. Sélectionnez "Add an item from the Insert tab" au milieu du contrôle Gallery pour sélectionner le modèle de la galerie.

4. Ajoutez un contrôle Label au modèle de la galerie.

5. Définissez la propriété Text sur ThisItem.FullMatch.

   La galerie est remplie de chaque mot de notre exemple de texte. Pour afficher tous les mots d’un seul écran, redimensionnez le modèle de la galerie et le contrôle d’étiquette.