Функции IsMatch, Match и MatchAll

Отнася се за: Приложения за платно Управлявани от модел Power Pages Power Platform приложения CLI

Тестове за съвпадение или извлича части от текстов низ на базата на шаблон.

Описание

Функцията IsMatch тества дали текстов низ съответства на шаблон, който може да съдържа обикновени символи, предварително дефинирани модели или редовен израз. Функциите Match и MatchAll връщат съвпадащото, включително под-съвпадения.

Използвайте IsMatch, за да потвърдите какво е въвел потребител във Въвеждане на текст контрола. Например, можете да потвърдите дали потребителят е въвел валиден имейл адрес, преди резултатът да бъде запазен във вашия източник на данни. Ако записът не отговаря на критериите ви, добавете други контроли, които подканят потребителя да коригира записа.

Използвайте Match за извличане на първия текстов низ, който съответства на шаблон и MatchAll за извличане на всички текстови низове, които съвпадат. Можете също да извлечете под-съвпадения, за да анализирате сложни низове.

Match връща запис на информация за първото намерено съвпадение, а MatchAll връща таблица със записи за всяко намерено съвпадение. Записът или записите съдържат:

Тези функции поддържат MatchOptions. По подразбиране:

• Тези функции изпълняват чувствително към регистъра съвпадение. Използвайте MatchOptions.IgnoreCase , за да извършвате съвпадения без значение към малки и големи букви.
• IsMatch съвпада с целия текстов низ (Complete MatchOption), докато Match и MatchAll търсят съвпадение навсякъде в текстовия низ (Contains MatchOption). Използвайте Complete, Contains, BeginsWith или EndsWith както е подходящо за вашия сценарий.

IsMatch връща true , ако текстовият низ съвпада с шаблона, или false , ако не съвпада. Съвпадението връща празно , ако не бъде намерено съвпадение, което може да бъде тествано с функцията IsBlank . MatchAll връща празна таблица, ако не бъде намерено съвпадение, което може да бъде тествано с функцията IsEmpty .

Ако използвате MatchAll, за да разделите текстов низ, помислете дали да използвате Split функция, която е по-проста за използване и по-бърза.

Модели

Ключът към използването на тези функции е в описанието на модела, който трябва да съответства. Описвате шаблона в текстов низ като комбинация от:

• Обикновени знаци, като например "abc" или "123".
• Предварително определени модели, като например Letter, MultipleDigits или Email. (Изброяването Match дефинира тези модели.)
• Кодове с регулярни изрази, като например "\d+\s+\d+" или "[a-z]+".

Комбинирайте тези елементи с помощта на оператора string-concatenation &. Например, "abc" & Digit & "\s+" е валиден шаблон, който съвпада със знаците "a", "b" и "c", последвани от цифра от 0 до 9, последвана от поне един знак за празно пространство.

Обикновени знаци

Най-простият модел е последователност от обикновени знаци, които трябва да бъдат точно съвпадащи.

Например, когато се използва с IsMatch функция, низът "Hello" съответства на модела "Hello" точно. Не повече и не по-малко. Низът "hello!" не съвпада с шаблона поради възклицателната точка в края и защото случаят е грешен за буквата "h". (Вижте MatchOptions за начини за промяна на това поведение.)

В езика на шаблона определени символи са запазени за специални цели. За да използвате тези знаци, или представете символа с \ (наклонена черта), за да се посочи, че героят трябва да се приема буквално или да се използва един от предварително дефинираните модели, описани по-долу в тази тема. Тази таблица изброява специалните знаци:

Например можете да съпоставите „Hello?“ като използвате модела "Hello\?" с обратна наклонена черта преди въпросителния знак.

Предварително определени модели

Предварително зададените модели предоставят прост начин да се съпостави или един от набор от знаци или последователност от няколко знака. Използвайте оператора за конкатенация на низове, за да комбинирате свои собствени текстови низове с членове на Matchизброяване :

Например, моделът "A" & MultipleDigits ще съвпадне с буквата "A", последвана от една или повече цифри.

Регулярни изрази

Моделът, който тези функции използват е редовен израз. Обикновените символи и предварително дефинираните модели, описани по-горе в тази тема, помагат за изграждането на регулярни изрази.

Редовните изрази са много мощни, предлагат се в много езици за програмиране и се използват за най-различни цели. Те често могат да изглеждат като произволна последователност от препинателни знаци. Тази статия не описва всички аспекти на регулярните изрази, но в интернет се предлага богата информация, уроци и инструменти.

Редовните изрази се предлагат в различни диалекти и Power Apps използва вариант на диалект на JavaScript. Вижте синтаксис с редовен израз за въведение в синтаксиса. Поддържат се именувани под-съвпадения (понякога наричани именувани групи за улавяне):

• Наименовани под-съвпадения: (?<name> ...)
• Наименовани обратни препратки: \k<name>

В таблицата за номериране Match таблица по-рано в тази тема, всеки enum се появява в същия ред, тъй като съответства на правилния израз.

Опции за съвпадение

Можете да промените поведението на тези функции, като посочите една или повече опции, които можете да комбинирате с помощта на оператора string- concatenation (&).

Използвайки MatchAll е еквивалентно на използването на стандартния "g" модификатор за регулярни изрази.

Синтаксис

IsMatch(Текст,Шаблон [, Опции ] )

• Текст – Задължително. Текстовият низ за тестване.
• Модел – Задължителен. Моделът за тестване като текстов низ. Свържете предварително дефинираните модели, които номерирането Match дефинира или предоставя редовен израз. Шаблонът трябва да е постоянна формула без променливи, източници на данни или други динамични препратки, които се променят по време на изпълнението на приложението.
• Опции – По избор. Комбинация от текстови низове на стойности на изброяване на MatchOptions. По подразбиране се използва MatchOptions.Complete.

Съвпадение(Текст,Шаблон [, Опции ] )

• Текст – Задължително. Текстовият низ за съответствие.
• Модел – Задължителен. Моделът за съответствие като текстов низ. Свържете предварително дефинираните модели, които номерирането Match дефинира или предоставя редовен израз. Шаблонът трябва да е постоянна формула без променливи, източници на данни или други динамични препратки, които се променят по време на изпълнението на приложението.
• Опции – По избор. Комбинация от текстови низове на стойности на изброяване на MatchOptions. По подразбиране се използва MatchOptions.Contains.

MatchAll(Текст,Шаблон [, Опции ] )

• Текст – Задължително. Текстовият низ за съответствие.
• Модел – Задължителен. Моделът за съответствие като текстов низ. Свържете предварително дефинираните модели, които номерирането Match дефинира или предоставя редовен израз. Шаблонът трябва да е постоянна формула без променливи, източници на данни или други динамични препратки, които се променят по време на изпълнението на приложението.
• Опции – По избор. Комбинация от текстови низове на стойности на изброяване на MatchOptions. По подразбиране се използва MatchOptions.Contains.

Примери за IsMatch

Обикновени знаци

Представете си, че приложението ви съдържа контрола Въвеждане на текст с име TextInput1. Потребителят въвежда стойности в този контрол, за да се съхранява в база данни.

Потребителските типове Здравей свят в TextInput1.

Предварително определени модели

Регулярни изрази

Примери Match и MatchAll

Нека да разгледаме последния пример. Ако искате да конвертирате този низ в стойност на дата / час, използвайки функцията Time, трябва да преминете в посочените под-съвпадения поотделно. За да направите това, можете да използвате функцията With, работеща върху записа, който Match връща:

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

За тези примери добавете контрола бутон, задайте свойството OnSelect на тази формула и след това изберете бутона:

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

Формула	Описание	Резултат
Match( pangram, "THE", IgnoreCase )	Намерете всички съвпадения на "THE" в текстовия низ, който съдържа променливата pangram. Низът съдържа две съвпадения, но само първото се връща, защото използвате Match, а не MatchAll. Колоната SubMatches е празна, защото не са дефинирани под-съвпадения.	{ FullMatch: "The", SubMatches: [ ], StartMatch: 32 }
MatchAll( pangram, "the" )	Намерете всички съвпадения на "the" в текстовия низ, който съдържа променливата pangram. Тестът е чувствителен към регистъра, така че е намерена само втората инстанция на "the". Колоната SubMatches е празна, защото не са дефинирани под-съвпадения.
MatchAll( pangram, "the", IgnoreCase )	Намерете всички съвпадения на "the" в текстовия низ, който съдържа променливата pangram. В този случай тестът е нечувствителен към регистъра, така че се откриват и двата случая на думата. Колоната SubMatches е празна, защото не са дефинирани под-съвпадения.
MatchAll( pangram, "\b\wo\w\b" )	Намира всички трибуквени думи с "о" в средата. Обърнете внимание, че „brown“ е изключено, тъй като не е трибуквена дума и следователно не успява да съвпадне „\b“ (граница на думата).
Match( pangram, "\b\wo\w\b\s\*(?<between>\w.+\w)\s\*\b\wo\w\b" )	Съответства на всички герои между "fox" и "dog".	{ между: "jumps over the lazy", FullMatch: "fox jumps over the lazy dog", SubMatches: [ "jumps over the lazy" ], StartMatch: 17 }

За да видите резултатите от MatchAll в галерия:

1. В празен екран поставете празна вертикала контрола Галерия.

2. Задаване свойството на галерията Елементи на MatchAll( pangram, "\w+" ) или MatchAll( pangram, MultipleLetters ).

   

3. Изберете „Добавете елемент от раздела „Вмъкване”” в средата на контролата за галерия, за да изберете шаблона на галерията.

4. Добавете контрола етикет към шаблона на галерията.

5. Задайте свойството Текст на етикета на ThisItem.FullMatch.

   Галерията е изпълнена с всяка дума от нашия пример. Преоразмерете шаблона на галерията и контрола на етикета, за да видите всички думи на един екран.