IsMatch, Matchi MatchAll funkcje

Dotyczy: Aplikacje kanwy Copilot Studio Oparte na modelu aplikacje interfejsu wiersza polecenia platformy Power Platform Funkcje usługi PowerVerse w usłudze Power Pages

Testuje dopasowanie lub wyodrębnia części ciągu tekstowego na podstawie wzorca.

Opis

Funkcja IsMatch sprawdza, czy ciąg tekstowy pasuje do wzorca, który może składać się ze zwykłych znaków, wstępnie zdefiniowanych wzorców lub wyrażenia regularnego. Funkcje Match i MatchAll zwracają dopasowanie, w tym podmaty.

Użyj IsMatch polecenia , aby sprawdzić, co użytkownik wpisił w kontrolce Wprowadzanie tekstu . Na przykład potwierdź, czy użytkownik wprowadził prawidłowy adres e-mail przed zapisaniem wyniku w źródle danych. Jeśli wpis nie jest zgodny z kryteriami, dodaj inne kontrolki, które monituje użytkownika o naprawienie wpisu.

Służy Match do wyodrębniania pierwszego ciągu tekstowego zgodnego ze wzorcem i MatchAll wyodrębniania wszystkich pasujących ciągów tekstowych. Wyodrębnianie podmatów w celu analizowania złożonych ciągów.

Match Zwraca rekord informacji dotyczących pierwszego znalezionego dopasowania i MatchAll zwraca tabelę rekordów dla każdego znalezionego dopasowania. Rekord lub rekordy zawierają następujące dane:

Te funkcje obsługują MatchOptions. Domyślnie:

• Te funkcje wykonują dopasowania z uwzględnieniem wielkości liter. Użyj funkcji MatchOptions.IgnoreCase, aby wykonać małe dopasowania bez uwzględniania spraw.
• IsMatch dopasuje cały ciąg tekstowy (Complete MatchOption) i MatchMatchAll wyszukuje dopasowanie w dowolnym miejscu w ciągu tekstowym (Zawiera matchOption). Użyj funkcji Complete, Contains, BeginsWith lub EndsWith w zależności od potrzeb.

IsMatch Zwraca wartość true , jeśli ciąg tekstowy pasuje do wzorca lub wartości false , jeśli nie. Match Zwraca wartość pustą , jeśli nie znaleziono dopasowania, które można przetestować za pomocą funkcji IsBlank . MatchAll Zwraca pustą tabelę, jeśli nie znaleziono dopasowania, które można przetestować za pomocą funkcji IsEmpty .

Jeśli używasz MatchAll metody do dzielenia ciągu tekstowego, rozważ użycie funkcji Split , która jest prostsza i szybsza.

Wzorce

Aby móc prawidłowo korzystać z tych funkcji, należy przede wszystkim opisać wzorzec używany do dopasowywania. Opisanie wzorca w ciągu tekstowym wymaga kombinacji następujących elementów:

• Znaków zwykłych, takich jak „abc” lub „123”.
• Wstępnie zdefiniowanych wzorców, takich jak Letter, MultipleDigits lub Email. (Wyliczenie Match definiuje te wzorce).
• Kody wyrażeń regularnych, takie jak „\d+\s+\d+” lub „[a-z]+”.

Połącz te elementy przy użyciu operatora łączenia ciągów i . Prawidłowy jest na przykład wzorzec "abc" & Digit & "\s+", który ma następującą postać: znaki „a”, „b” i „c”, cyfry z przedziału od 0 do 9 i co najmniej jeden znak odstępu.

Znaki zwykłe

Najprostszy wzorzec to sekwencja zwykłych znaków, które dokładnie pasują.

Na przykład w przypadku użycia z funkcją IsMatch ciąg "Hello" pasuje dokładnie do wzorca "Hello". Dopasowanie jest dokładne. Ciąg "hello!" nie pasuje do wzorca ze względu na wykrzyknik na końcu i dlatego, że wielkość liter "h" jest nieprawidłowa. (Zobacz Match opcje sposobów modyfikowania tego zachowania).

W języku wzorca znaki . ? * + ( ) [ ] ^ $ | \ są zastrzeżone do celów specjalnych. Aby użyć tych znaków, prefiks znaku z (ukośnikiem odwrotnym \ ), aby wskazać, że znak powinien być traktowany dosłownie lub użyć jednego ze wstępnie zdefiniowanych wzorców. Na przykład można dopasować ciąg "Hello?" przy użyciu wzorca "Hello\\?" z ukośnikiem odwrotnym przed znakiem zapytania.

Wstępnie zdefiniowane wzorce

Wstępnie zdefiniowane wzorce pozwalają w prosty sposób dopasować jeden znak z zestawu lub sekwencję wielu znaków. Użyj operatora łączenia ciągów i połącz własne ciągi tekstowe z elementami wyliczenia Match :

Na przykład wzorzec "A" i MultipleDigits pasuje do litery "A", po której następuje co najmniej jedna cyfra.

Usługa Power Apps używa innej definicji dla programu Match. Poczta e-mail i Match. Łącznik. Oceń Text( Match.Email ) , aby wyświetlić wyrażenie regularne używane przez hosta.

Wyrażenia regularne

Wzorzec używany przez te funkcje jest nazywany wyrażeniem regularnym. Specyficzny dialekt wyrażeń regularnych power Fx jest szczegółowo opisany w wyrażeniach regularnych w programie Power Fx.

Wyrażenia regularne są zaawansowane i pełnią szeroką gamę celów. Mogą również wyglądać jak losowa sekwencja znaków interpunkcyjnych. Ten artykuł nie opisuje wszystkich aspektów wyrażeń regularnych, ale w Internecie dostępnych jest wiele informacji, samouczków i narzędzi.

Wyrażenia regularne mają długą historię i są dostępne w wielu językach programowania. Każdy język programowania ma swój własny zbiór wyrażeń regularnych i istnieje kilka standardów. Staramy się zapewnić, że to samo wyrażenie regularne daje ten sam wynik we wszystkich implementacjach Power Fx. Kompatybilność nie jest łatwa do osiągnięcia, ponieważ Power Fx działa na JavaScript i .NET, które mają znaczące różnice. Aby obsłużyć uruchamianie na różnych platformach, wyrażenia regularne usługi Power Fx są ograniczone do podzbioru funkcji, które są powszechnie obsługiwane w całej branży.

W związku z tym niektóre wyrażenia regularne, które mogą działać w innych środowiskach, mogą być blokowane lub wymagają dostosowania w programie Power Fx. Błędy czasu tworzenia są zgłaszane w przypadku napotkania nieobsługiwanych funkcji. Jest to jeden z powodów, dla których wyrażenie regularne i opcje muszą być stałą czasu tworzenia, a nie dynamiczną (na przykład podaną w zmiennej).

Poniżej przedstawiono kilka podstawowych elementów wyrażeń regularnych, które tworzą złożoność analizowania liczby.

Te przykłady dają tylko niewielki smak tego, co mogą robić wyrażenia regularne. Są one często używane do weryfikowania numerów identyfikacyjnych, adresów e-mail, numerów telefonów, dat i godzin oraz wyodrębniania informacji z wszystkich rodzajów plików tekstowych. Kontynuuj swoją podróż, czytając wyrażenia regularne w programie Power Fx, eksperymentuj i korzystaj z Internetu, aby dowiedzieć się więcej.

Match Opcje

Zmodyfikuj zachowanie tych funkcji, określając co najmniej jedną opcję, którą łączysz przy użyciu operatora łączenia ciągów (&).

Użycie MatchAll jest takie samo jak użycie standardowego modyfikatora "g" dla wyrażeń regularnych.

Składnia

IsMatch( Tekst, Wzorzec [, Opcje ] )

• Tekst – wymagane. Testowany ciąg tekstowy.
• Wzór – wymagane. Testowany wzorzec w postaci ciągu tekstowego. Połącz wstępnie zdefiniowane wzorce, które wyliczenie Match definiuje lub udostępnia wyrażenie regularne. Wzorzec musi być stałą formułą bez zmiennych, źródeł danych lub innych odwołań dynamicznych, które zmieniają się w miarę uruchamiania aplikacji. Należy pamiętać, że formuła musi być wyrażona jako "Match. Wstępnie zdefiniowanypattern", np. Match. E-mail
• Opcje – Opcjonalnie. Ciąg tekstowy w połączeniu z wartościami wyliczeniowymi wyrażenia MatchOptions. Domyślnie używane jest wyrażenie MatchOptions.Complete. Opcje muszą być stałą formułą bez zmiennych, źródeł danych lub innych odwołań dynamicznych, które zmieniają się w miarę uruchamiania aplikacji.

Match( Tekst, Wzorzec [, Opcje ] )

• Tekst – wymagane. Dopasowany ciąg tekstowy.
• Wzór – wymagane. Dopasowany wzorzec w postaci ciągu tekstowego. Połącz wstępnie zdefiniowane wzorce zdefiniowane przez Match wyliczenie lub podaj wyrażenie regularne. Wzorzec musi być stałą formułą bez żadnych zmiennych, źródeł danych ani innych odwołań dynamicznych, które zmieniają się wraz z działaniem aplikacji.
• Opcje – Opcjonalnie. Ciąg tekstowy w połączeniu z wartościami wyliczeniowymi wyrażenia MatchOptions. Domyślnie używane jest wyrażenie MatchOptions.Contains. Opcje muszą być stałą formułą bez żadnych zmiennych, źródeł danych lub innych odwołań dynamicznych, które zmieniają się w miarę uruchamiania aplikacji.

MatchAll( Tekst, Wzorzec [, Opcje ] )

• Tekst – wymagane. Dopasowany ciąg tekstowy.
• Wzór – wymagane. Dopasowany wzorzec w postaci ciągu tekstowego. Połącz wstępnie zdefiniowane wzorce, które wyliczenie Match definiuje lub udostępnia wyrażenie regularne. Wzorzec musi być stałą formułą bez zmiennych, źródeł danych lub innych odwołań dynamicznych, które zmieniają się w miarę uruchamiania aplikacji.
• Opcje – Opcjonalnie. Ciąg tekstowy w połączeniu z wartościami wyliczeniowymi wyrażenia MatchOptions. Domyślnie używane jest wyrażenie MatchOptions.Contains. Opcje muszą być stałą formułą bez zmiennych, źródeł danych lub innych odwołań dynamicznych, które zmieniają się w miarę uruchamiania aplikacji.

IsMatch Przykłady

Znaki zwykłe

Załóżmy, że aplikacja ma kontrolkę Wprowadzanie tekstu o nazwie TextInput1. Użytkownicy wprowadzają wartości do tej kontrolki, aby przechowywać je w bazie danych.

Użytkownicy wpiszą ciąg Hello world w polu TextInput1.

Wstępnie zdefiniowane wzorce

Wyrażenia regularne

Matchprzykłady i MatchAll

Zagłębmy się bardziej w ten ostatni temat. Jeśli chcesz przekonwertować ten ciąg na wartość daty/godziny przy użyciu funkcji Time , musisz przekazać indywidualnie nazwane podmaty. Aby to zrobić, użyj funkcji With działającej na rekordzie, który Match zwraca:

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

Aby zapoznać się z tymi przykładami, należy dodać kontrolkę Przycisk, ustawić jego właściwość OnSelect na tę formułę, a następnie wybrać przycisk:

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

Wzór	Opis	Wynik
Match( pangram, "THE", IgnoreCase )	Znajdź wszystkie dopasowania elementu "THE" w ciągu tekstowym, który zawiera zmienna pangram. Ciąg zawiera dwa dopasowania, ale zwracany jest tylko pierwszy, ponieważ używasz Match elementu , a nie MatchAll.	{ FullMatch: "The", StartMatch: 32 }
MatchAll( pangram, "the" )	Znajdź wszystkie dopasowania elementu "the" w ciągu tekstowym, który zawiera zmienna pangram. W teście jest rozróżniana wielkość liter, więc znalezione zostanie tylko drugie wystąpienie elementu "the".
MatchAll( pangram, "the", IgnoreCase )	Znajdź wszystkie dopasowania elementu "the" w ciągu tekstowym, który zawiera zmienna pangram. W tym przypadku podczas testu nie jest rozróżniana wielkość liter, więc można znaleźć zarówno wystąpienia danego wyrazu.
MatchAll( pangram, "\b\wo\w\b" )	Program znajduje wszystkie trzyliterowe wyrazy ze znakiem "o" w środku. "brązowy" jest wykluczony, ponieważ nie jest to trzyliterowy wyraz i dlatego nie pasuje do "\b" (granica słowa).
Match( pangram, "\b\wo\w\b\s\*(?<between>\w.+\w)\s\*\b\wo\w\b" )	Odpowiada wszystkim znakom między "fox" i "dog".	{ pomiędzy: "jumps over the lazy", FullMatch: "lis skacze nad leniwym psem", StartMatch: 17 }

Aby wyświetlić wyniki w MatchAll galerii:

1. Na pustym ekranie wstaw pustą pionową kontrolkę galerii .

2. Ustaw właściwość Items galerii na MatchAll( pangram, "\w+" ) lub MatchAll( pangram, MultipleLetters ).

   

3. Wybierz "Dodaj element z karty Wstaw" w środku kontrolki galerii, aby wybrać formularz galerii.

4. Dodaj kontrolkę Label do szablonu galerii.

5. Ustaw właściwość Text kontrolki etykiety na ThisItem.FullMatch.

   W galerii jest wypełniany każdy wyraz w tekście przykładowym. Aby wyświetlić wszystkie wyrazy na jednym ekranie, zmień rozmiar szablonu galerii i kontrolki etykiety.