IsMatch, и MatchMatchAll функции

Применимо к: Приложения На основе холста Приложения Copilot Studio, управляемые моделью приложения Power Platform CLI Dataverse, функции Power Pages

Проверяет совпадение или извлекает части текстовой строки на основе шаблона.

Описание

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

Используется IsMatch для проверки типа пользователя в элементе управления "Ввод текста ". Например, убедитесь, что пользователь ввел допустимый адрес электронной почты перед сохранением результата в источнике данных. Если запись не соответствует вашим критериям, добавьте другие элементы управления, которые побудит пользователя исправить запись.

Используется Match для извлечения первой текстовой строки, соответствующей шаблону, и MatchAll для извлечения всех текстовых строк, которые соответствуют. Извлеките вложенные знаки для синтаксического анализа сложных строк.

Match возвращает запись сведений для первого найденного совпадения и MatchAll возвращает таблицу записей для каждого найденного совпадения. Запись или записи содержат:

Эти функции поддерживают MatchOptions. По умолчанию:

• Эти функции выполняют поиск с учетом регистра. Используйте MatchOptions.IgnoreCase для поиска совпадений независимо от регистра.
• IsMatch соответствует всей текстовой строке (Complete MatchOption), а также MatchMatchAll ищет совпадение в любом месте текстовой строки (Contains MatchOption). Используйте Complete, Contains, BeginsWith или EndsWith в соответствии со своим сценарием.

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

Если вы используете для разделения текстовой строки, рекомендуется использовать MatchAll функцию Split , которая проще и быстрее.

Шаблоны

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

• Обычные символы, такие как "abc" или "123".
• Предопределенные шаблоны, такие как Letter, MultipleDigits или Email. (Перечисление Match определяет эти шаблоны.)
• Коды регулярных выражений, например "\d+\s+\d+" или "[a-z]+".

Объединяйте эти элементы с помощью оператора сцепления строк и >. Например, "abc" & Digit & "\s+" является допустимым шаблоном, который соответствует символам "a", "b" и "c" с последующей цифрой от 0 до 9, за которой следует по крайней мере один пробел.

Обычные символы

Самый простой шаблон — это последовательность обычных символов, которые точно соответствуют.

Например, при использовании с IsMatch функцией строка Hello точно соответствует шаблону Hello . И никак иначе. Строка "hello!" не соответствует шаблону из-за восклицательного знака в конце и потому, что дело неправильно для буквы "h". (См Match . параметры изменения этого поведения.)

На языке шаблонов символы зарезервированы . ? * + ( ) [ ] ^ $ | \ для специальных целей. Чтобы использовать эти символы, либо префикс символа с \ помощью (обратной косой черты), чтобы указать, что символ должен приниматься буквально или использовать один из предопределенных шаблонов. Например, можно сопоставить строку "Hello?" с помощью шаблона "Hello\\?" с обратной косой чертой перед вопросительным знаком.

Предопределенные шаблоны

Предопределенные шаблоны предоставляют простой способ сопоставления либо с одним из наборов символов либо с последовательностью из нескольких символов. Используйте оператор объединения строк и объединить собственные текстовые строки с элементами перечисления Match :

Например, шаблон "A" и MultipleDigits соответствует букве "A", за которой следует одна или несколько цифр.

Power Apps использует другое определение дляMatch . EMail и Match. Дефис. Оцените Text( Match.Email ) регулярное выражение, используемое узлом.

Регулярные выражения

Шаблон, используемый этими функциями, называется регулярным выражением. Конкретный диалект регулярных выражений PowerFx подробно описан в регулярных выражениях в Power Fx.

Регулярные выражения являются мощными и служат широкому спектру целей. Они также могут выглядеть как случайная последовательность знаков препинания. В этой статье не описываются все аспекты регулярных выражений, но огромное количество информации, руководств и инструментов доступно в Интернете.

Регулярные выражения имеют долгую историю и доступны во многих языках программирования. У каждого языка программирования есть свой диалект регулярных выражений, и стандартов немного. Мы стремимся обеспечить одинаковый регулярный результат для всех реализаций Power Fx. Совместимость обеспечить непросто, поскольку Power Fx работает поверх JavaScript и .NET, которые имеют существенные различия. Для размещения на разных платформах регулярные выражения Power Fx ограничены подмножеством функций, которые широко поддерживаются в отрасли.

В результате некоторые регулярные выражения, которые могут работать в других средах, могут быть заблокированы или требуют настройки в Power Fx. Ошибки времени авторизации сообщаются при обнаружении неподдерживаемых функций. Это одна из причин, по которым регулярное выражение и параметры должны быть константой времени разработки, а не динамической (например, предоставленной в переменной).

Ниже приведены некоторые основные элементы регулярных выражений, которые создают сложность при анализе числа.

Эти примеры дают лишь небольшой вкус того, что могут делать регулярные выражения. Они обычно используются для проверки идентификаторов, адресов электронной почты, номеров телефонов, дат и времени, а также для извлечения информации из всех типов текстовых файлов. Продолжайте свое путешествие, читая регулярные выражения в Power Fx, эксперименте и используя Интернет, чтобы узнать больше.

Match варианты

Измените поведение этих функций, указав один или несколько параметров, которые объединяются с помощью оператора объединения строк (&>).

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

Синтаксис

IsMatch( Текст, шаблон [, параметры ] )

• Текст – Обязательно. Текстовая строка для проверки.
• Шаблон – Обязательно. Шаблон для проверки в виде текстовой строки. Сцепляющие предопределенные шаблоны, определяющие Match перечисление или предоставляющие регулярное выражение. Шаблон должен быть константной формулой без переменных, источников данных или других динамических ссылок, которые изменяются при запуске приложения. Обратите внимание, что формула должна быть выражена как "Match. ПредопределенныйPattern, например Match. Отправить по электронной почте
• Параметры – Необязательно. Сочетание значений перечисления MatchOptions в виде текстовой строки. По умолчанию используется MatchOptions.Complete. Параметры должны быть константной формулой без переменных, источников данных или других динамических ссылок, которые изменяются при запуске приложения.

Match( Текст, шаблон [, параметры ] )

• Текст – Обязательно. Текстовая строка для сопоставления.
• Шаблон – Обязательно. Шаблон для сопоставления в виде текстовой строки. Сцепление предопределенных шаблонов, Match определяемых перечислением или предоставление регулярного выражения. Шаблон должен представлять собой постоянную формулу без каких-либо переменных, источников данных или других динамических ссылок, которые изменяются по мере работы приложения.
• Параметры – Необязательно. Сочетание значений перечисления MatchOptions в виде текстовой строки. По умолчанию используется MatchOptions.Contains. Параметры должны быть константной формулой без переменных, источников данных или других динамических ссылок, которые изменяются при запуске приложения.

MatchAll( Текст, шаблон [, параметры ] )

• Текст – Обязательно. Текстовая строка для сопоставления.
• Шаблон – Обязательно. Шаблон для сопоставления в виде текстовой строки. Сцепляющие предопределенные шаблоны, определяющие Match перечисление или предоставляющие регулярное выражение. Шаблон должен быть константной формулой без переменных, источников данных или других динамических ссылок, которые изменяются при запуске приложения.
• Параметры – Необязательно. Сочетание значений перечисления MatchOptions в виде текстовой строки. По умолчанию используется MatchOptions.Contains. Параметры должны быть константной формулой без переменных, источников данных или других динамических ссылок, которые изменяются при запуске приложения.

IsMatch Примеры

Обычные символы

Представьте, что в приложении есть элемент управления вводом текста с именем TextInput1. Пользователи вводят значения в этот элемент управления для хранения их в базе данных.

Пользователи введите мир Hello в 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 ) )
)

Для этих примеров добавьте элемент управления Button, задайте для его свойства OnSelect эту формулу, а затем выберите кнопку:

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

Формула	Описание	Результат
Match( pangram, "THE", IgnoreCase )	Найти все совпадения с "THE" в текстовой строке, которую содержит переменная pangram. Строка содержит два совпадения, но возвращается только первая, так как используется Match и не MatchAllиспользуется.	{ FullMatch: "The", StartMatch: 32 }
MatchAll( pangram, "the" )	Найти все совпадения с "the" в текстовой строке, которую содержит переменная pangram. Тест чувствителен к регистру, поэтому найден только второй экземпляр "the".
MatchAll( pangram, "the", IgnoreCase )	Найти все совпадения с "the" в текстовой строке, которую содержит переменная pangram. В этом случае тест нечувствителен к регистру, поэтому найдены оба вхождения слова.
MatchAll( pangram, "\b\wo\w\b" )	Находит все слова из трех букв с буквой "o" в середине. "коричневый" исключается, потому что это не трехбуквенный слово и, следовательно, не соответствует "\b" (граница слова).
Match( pangram, "\b\wo\w\b\s\*(?<between>\w.+\w)\s\*\b\wo\w\b" )	Соответствует всем символам между "fox" и "dog".	{ между: "прыгает через ленивый", FullMatch: "фоска прыгает над ленивой собакой", StartMatch: 17 }

Чтобы просмотреть результаты коллекции, выполните следующие действия MatchAll .

1. В пустом экране вставьте пустой элемент управления вертикальной коллекции .

2. Задайте для свойства Items коллекции значение MatchAll(pangram, \w+) или MatchAll(pangram, MultipleLetters ).

   

3. Выберите "Добавить элемент с вкладки «Вставка»" в центре элемента управления коллекции, чтобы выбрать шаблон коллекции.

4. Добавьте элемент управления Label к шаблону коллекции.

5. Задайте для свойства Text метки выражение ThisItem.FullMatch.

   Коллекция заполняется каждым словом в нашем примере текста. Чтобы просмотреть все слова на одном экране, измените размер шаблона коллекции и элемента управления метками.