Funktionerna IsMatch, Match och MatchAll

Gäller: Arbetsyteappar Modellbaserade appar Power Platform CLI

Test för en matchning eller extraherar delar av en textsträng baserat på ett mönster.

Beskrivning

Funktionen IsMatch testar om en textsträng matchar ett mönster som kan innefatta vanliga tecken, fördefinierade mönster eller ett reguljärt uttryck. Funktionerna Match och MatchAll returnerar vad som matchades, inklusive underordnade matchningar.

Använd IsMatch för att verifiera vad en användare har skrivit i en Text Input-kontroll. Exempelvis kan du kontrollera om användaren har angett en giltig e-postadress innan resultatet sparas till din datakälla. Om posten inte matchar dina kriterier kan du lägga till andra kontroller som uppmanar användaren att korrigera posten.

Använd Match för att extrahera den första textsträngen som överensstämmer med ett mönster och MatchAll för att extrahera alla textsträngar som överensstämmer. Du kan även extrahera underordnade matchningar för att analysera komplexa strängar.

Match returnerar en post med information för den första matchningen och MatchAll returnerar en tabell med poster för varje matchning som hittats. Posten eller posterna innehåller:

Dessa funktioner stöder MatchOptions. Som standard:

• Dessa funktioner utför en skiftlägeskänslig matchning. Använd MatchOptions.IgnoreCase för att utföra skiftlägeskänsliga matchningar.
• IsMatch matchar hela textsträngen (Complete MatchOption), medan Match och MatchAll söker efter en matchning var som helst i textsträngen (Contains MatchOption). Use Complete, Contains, BeginsWith eller EndsWith som passar ditt scenario.

IsMatch returnerar true om textsträngen matchar mönstret eller false om den inte gör det. Match returnerar blank om det inte finns någon matchning som kan testas med funktionen IsBlank. MatchAll returnerar om det inte finns någon matchning som kan testas med funktionen IsEmpty.

Om du använder MatchAll för att dela upp en text sträng bör du överväga att använda funktionen Split som är enklare och snabbare att använda.

Mönster

Dessa funktioner används genom att man beskriver det mönster som ska matchas. Du beskriver mönstret i en textsträng som en kombination av:

• Vanliga tecken, till exempel "abc" eller "123".
• Fördefinierade mönster, till exempel Letter, MultipleDigits eller Email. (Uppräkningen Match definierar dessa mönster.)
• Reguljära uttryckskoder som "\d+\s+\d+" eller "[a-z] +".

Kombinera de här elementen genom att använda strängsammanfogningens operatör &. Till exempel är "abc" & Digit & "\s+" ett giltigt mönster som matchar tecknen "a", "b" och "c", följt av en siffra från 0 till 9, följt av minst ett blanksteg.

Vanliga tecken

Den enklaste mönstret är en sekvens av vanliga tecken som ska matchas exakt.

Om t.ex. används med funktionen IsMatch matchar strängen "Hello" matchar mönster exakt "Hello". Varken mer eller mindre. Strängen "hello!" matchar inte mönstret på grund av utropstecknet i slutet och att bokstaven "h" är gemen. (Se MatchOptions för metoder att ändra det här beteendet.)

I mönsterspråket är vissa tecken reserverade för speciella ändamål. Om du vill använda dessa tecken sätter du antingen ett prefix på tecknet med ett \ (omvänt snedstreck) för att visa att tecknet ska tolkas bokstavligen, eller så använder du något av de fördefinierade mönstren som beskrivs senare i detta ämne. Följande tabell visar specialtecknen:

Du kan till exempel matcha "Hello?" med hjälp av mönstren "Hello\?" med en omvänt snedstreck före frågetecknet.

Fördefinierade mönster

Fördefinierade mönster är ett enkelt sätt att matcha en uppsättning tecken, eller en sekvens med flera tecken. Använd strängsammanfogningens operator & till att kombinera egna textsträngar med medlemmar i uppräkningen Match:

Till exempel kommer mönstret "A" & MultipleDigits matcha bokstaven "A" följt av en eller flera siffror.

Reguljära uttryck

Det mönster som de här funktionerna använder är ett reguljärt uttryck. De vanliga karaktärerna och fördefinierade mönster som beskrivs tidigare i detta ämne hjälper till att bygga regelbundna uttryck.

Reguljära uttryck är mycket kraftfulla, finns i många programmeringsspråk och används för en mängd olika syften. De kan också ofta se ut som en slumpmässig sekvens av skiljetecken. Det går inte att i den här artikeln beskriva alla aspekter av reguljära uttryck, men det finns mängder av information, handledning och verktyg finns tillgängliga på webben.

Reguljära uttryck har olika dialekter och i Power Apps används en variant av JavaScript-dialekten. Se reguljärt uttryck syntax för en introduktion till syntax. Namngivna under matchningar (kallas ibland namngivna registreringsgrupper) stöds:

• Namngivna under matchningar: (?<name> ...)
• Namngivna bakreferenser: \k<name>

I tabellen Match för matchning tidigare i den här ämne visas varje enum på samma rad som motsvarande reguljära uttryck.

Alternativ för matchning

Du kan ändra beteendet hos dessa funktioner genom att ange ett eller flera alternativ, som du kan kombinera med hjälp av strängkopplingens operatör (&).

Använda MatchAll motsvarar användning av standard "g"-modifieraren för vanliga uttryck.

Syntax

IsMatch( Text, Pattern [, Options ] )

• Text – obligatoriskt. Textsträngen som ska testas.
• Pattern – Krävs. Mönster som ska testas, som en textsträng. Sammanfoga fördefinierade mönster som uppräkningen Match definierar, eller ange ett reguljärt uttryck. Pattern måste vara en konstant formel utan variabler, data källor eller andra dynamiska referenser som ändras när programmet körs.
• Options – Valfritt. En textsträngskombination av uppräkningsvärden i MatchOptions. Som standard används MatchOptions.Complete.

Match( Text, Pattern [, Options ] )

• Text – obligatoriskt. Textsträngen som ska match.
• Pattern – Krävs. Mönster som ska match, som en textsträng. Sammanfoga fördefinierade mönster som uppräkningen Match definierar, eller ange ett reguljärt uttryck. Pattern måste vara en konstant formel utan variabler, data källor eller andra dynamiska referenser som ändras när programmet körs.
• Options – Valfritt. En textsträngskombination av uppräkningsvärden i MatchOptions. Som standard används MatchOptions.Contains.

MatchAll( Text, Pattern [, Options ] )

• Text – obligatoriskt. Textsträngen som ska match.
• Pattern – Krävs. Mönster som ska match, som en textsträng. Sammanfoga fördefinierade mönster som uppräkningen Match definierar, eller ange ett reguljärt uttryck. Pattern måste vara en konstant formel utan variabler, data källor eller andra dynamiska referenser som ändras när programmet körs.
• Options – Valfritt. En textsträngskombination av uppräkningsvärden i MatchOptions. Som standard används MatchOptions.Contains.

IsMatch exempel

Vanliga tecken

Vi antar att ditt program innehåller en Text Input-kontroll med namnet TextInput1. Användaren anger värden i den här kontrollen som ska lagras i en databas.

Användaren skriver Hello world i TextInput1.

Fördefinierade mönster

Reguljära uttryck

Match och MatchAll exempel

Låt oss detaljgranska i det förra exemplet. strängOm du vill konvertera den här strängen till ett datum/tid-värde med hjälp av funktionen Time tid måste du överföra samma underordnade matchningar separat. Om du vill göra detta kan du använda With som fungerar på posten som Match returnerar:

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

I dessa exempel lägger du till en Button kontroll anger du dess egenskap OnSelect för den här formeln och markerar sedan knappen:

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

Formel	Beskrivning	Resultat
Match( pangram, "THE", IgnoreCase )	Sök efter alla matchningar av "THE" i den textsträng som pangram-variabeln innehåller. Strängen innehåller två matchningar, men endast den första returneras eftersom du använder Match och inte MatchAll. Kolumnen SubMatches är tom eftersom inga undermatchningar har definierats.	{ FullMatch: "The", SubMatches: [ ], StartMatch: 32 }
MatchAll( pangram, "the" )	Sök efter alla matchningar av "the" i den textsträng som pangram-variabeln innehåller. Testet är skiftlägeskänsligt, så att endast den andra instansen av "the" hittas. Kolumnen SubMatches är tom eftersom inga undermatchningar har definierats.
MatchAll( pangram, "the", IgnoreCase )	Sök efter alla matchningar av "the" i den textsträng som pangram-variabeln innehåller. I det här fallet är testet inte skiftlägeskänsligt, så båda instanserna av ordet hittas. Kolumnen SubMatches är tom eftersom inga undermatchningar har definierats.
MatchAll( pangram, "\b\wo\w\b" )	Söker efter alla tre bokstäver med ett "o"-ord i mitten. Observera att "brun" inte är ett ord som består av tre bokstäver och därför inte kan matchas med "\b" (ordgräns).
Match( pangram, "\b\wo\w\b\s\*(?<between>\w.+\w)\s\*\b\wo\w\b" )	Matchar alla tecken mellan "räv" och "hund".	{ between: "jumps over the lazy", FullMatch: "fox jumps over the lazy dog", SubMatches: [ "jumps over the lazy" ], StartMatch: 17 }

Så här visar du resultatet av MatchAll i ett galleri:

1. På en tom skärm sätter du in en tom lodrät Gallery kontroll.

2. Ange galleriets egenskap Items till MatchAll( pangram, "\w+" ) eller MatchAll( pangram, MultipleLetters ).

   

3. Välj "Lägg till ett objekt från fliken Infoga" i mitten av gallerikontrollen för att välja mall för galleriet.

4. Lägg till en Label i gallerimallen.

5. Ställ in etikettens Text till ThisItem.FullMatch.

   Galleriet fylls i med varje ord i vår exempeltext. Ändra storlek på galleriets mall och label-kontrollen så att alla ord visas på samma skärm.