IsMatch、 Match、および MatchAll 関数

適用対象: キャンバス アプリ Copilot Studio モデル駆動型アプリ Power Platform CLI Dataverse 関数 Power Pages

パターンに基づいてテキスト文字列の一致をテストまたは抽出します。

内容

IsMatch関数は、テキスト文字列が通常の文字、定義済みのパターン、または正規表現を構成できるパターンと一致するかどうかをテストします。 Match関数とMatchAll関数は、サブマッチを含め、一致した内容を返します。

IsMatchを使用して、ユーザーがテキスト入力コントロールに入力した内容を検証します。 たとえば、結果がデータ ソースに保存される前に、ユーザーが有効なメール アドレスを入力したかどうかを確認します。 エントリが条件と一致しない場合は、ユーザーにエントリの修正を求める他のコントロールを追加します。

Matchを使用して、パターンに一致する最初のテキスト文字列を抽出し、一致するすべてのテキスト文字列を抽出MatchAllします。 サブマッチを抽出して複雑な文字列を解析します。

Match は最初に見つかった一致の情報のレコードを返し、 MatchAll は見つかったすべての一致のレコードのテーブルを返します。 レコードまたはレコードには次のものが含まれます:

これらの関数はMatchOptions をサポートします。 既定:

• これらの関数は、大文字と小文字を区別する一致を実行します。 大文字と小文字を区別しない照合を実行するには MatchOptions.IgnoreCase を使用します。
• IsMatchはテキスト文字列全体 (Complete MatchOption) と一致し、テキスト文字列内の任意の場所 (MatchOption を含む) をMatchして検索MatchAll。 シナリオに応じて完了、含む、BeginsWith、または EndsWith を使用します。

IsMatch は、テキスト文字列がパターンと一致する場合は true 、一致しない場合は false を返します。 Match は、IsBlank 関数でテストできる一致が見つからない場合は空白を返します。 MatchAll IsEmpty 関数でテストできる一致が見つからない場合は、空のテーブルが返されます。

MatchAllを使用してテキスト文字列を分割する場合は、Split 関数を使用することを検討してください。これは、より簡単で高速です。

パターン

これらの関数を使用する鍵は、一致のパターンを記述することです。 パターンは、以下を組み合わせたテキスト文字列で記述します:

• "abc" や "123" などの通常文字。
• レター、MultipleDigits、電子メール などの事前定義済みのパターン。 ( Match 列挙型はこれらのパターンを定義します)。
• "\d+\s+\d+" または "[a-z]+" などの正規表現コード。

文字列連結演算子 > を使用してこれらの要素を結合します。 たとえば、"abc" & Digit & "\s+" は有効なパターンであり、後ろに 0 から 9 までの数字と少なくとも 1 つの空白文字が付いた文字 "a"、"b"、"c" に一致します。

通常文字

最も単純なパターンは、正確に一致する通常の文字のシーケンスです。

たとえば、 IsMatch 関数で使用する場合、文字列 "Hello" は パターン "Hello" と 正確に一致します。 過不足がありません。 文字列 "hello!" は、末尾の感嘆符と文字 "h" の大文字と小文字が間違っているため、パターンと一致しません。 (この動作を変更する方法については、 Match オプション を参照してください)。

パターン言語では、 . ? * + ( ) [ ] ^ $ | \ 文字は特別な目的のために予約されています。 これらの文字を使用するには、文字の前に \ (円記号) を付けて文字を文字として取る必要があることを示すか、定義済みのパターンのいずれかを使用します。 たとえば、パターン "Hello?"を疑問符の前に円記号を付けて使用することで、文字列"Hello\\?"を照合できます。

事前定義済みパターン

事前定義済みのパターンは、文字セットの 1 つ、または一連の複数の文字を簡単に一致させる方法を提供します。 文字列連結演算子 & を使用して、独自のテキスト文字列をMatch列挙型のメンバーと結合します。

たとえば、パターン "A" と MultipleDigits は 、文字 "A" の後に 1 桁以上の数字が続く文字と一致します。

Power Apps では、Matchに別の定義が使用されます。電子メールとMatch。ハイフン。 Text( Match.Email )を評価して、ホストで使用されている正規表現を確認します。

正規表現

これらの関数で使用されるパターンは 、正規表現と呼ばれます。 Power Fx の正規表現の特定の方言は、 Power Fx の正規表現で詳しく説明されています。

正規表現は強力であり、さまざまな目的に対応します。 また、句読点のランダムなシーケンスのように見えることもあります。 この記事では、正規表現のすべての側面について説明するわけではありませんが、豊富な情報、チュートリアル、ツールをオンラインで利用できます。

正規表現は長い歴史があり、多くのプログラミング言語で使用できます。 すべてのプログラミング言語には正規表現の独自の方言があり、標準はほとんどありません。 同じ正規表現がすべての Power Fx 実装で同じ結果を得られるように努めています。 互換性は、大きな違いがある JavaScript と .NET 上で Power Fx が実行されるため、簡単には実現できません。 さまざまなプラットフォームでの実行に対応するために、Power Fx 正規表現は、業界全体で広くサポートされている機能のサブセットに限定されています。

その結果、他の環境で動作する可能性のある正規表現の一部がブロックされたり、Power Fx で調整が必要になる場合があります。 作成時間エラーは、サポートされていない機能が発生すると報告されます。 これは、正規表現とオプションが動的ではなくオーサリング時間定数である必要がある理由の 1 つです (たとえば、変数で指定されます)。

数値の解析の複雑さを増す正規表現の基本的な要素を次に示します。

これらの例では、正規表現でできることの少しの味しか与えられません。 ID 番号、メール アドレス、電話番号、日付と時刻を検証し、あらゆる種類のテキスト ファイルから情報を抽出するために一般的に使用されます。 Power Fx で正規表現を読み、実験し、Web を使用して詳細を確認して、体験を続けます。

Match のオプション

これらの関数の動作を変更するには、文字列連結演算子 (> を使用して結合する 1 つ以上のオプション) を指定します。

MatchAllの使用は、正規表現に標準の "g" 修飾子を使用する場合と同じです。

構文

IsMatch( Text, Pattern [, Options ] )

• テキスト – 必須。 テストするテキスト文字列。
• パターン – 必須。 テキスト文字列としてテストするパターン。 Match列挙型が定義または正規表現を提供する定義済みのパターンを連結します。 パターン は、変数、データ ソース、またはアプリの実行時に変更されるその他の動的参照を含まない定数数式である必要があります。 式は "Match" として表す必要があることに注意してください。PredefinedPattern" (例: Match)。電子メール
• オプション – オプション。 MatchOptions 列挙値を組み合わせたテキスト文字列。 既定では MatchOptions.Complete が使用されます。 オプション は、変数、データ ソース、またはアプリの実行時に変更されるその他の動的参照を含まない定数数式である必要があります。

Match( Text, Pattern [, Options ] )

• テキスト – 必須。 一致するテキスト文字列。
• パターン – 必須。 テキスト文字列として一致するパターン。 Match列挙型が定義する定義済みのパターンを連結するか、正規表現を指定します。 パターン は、アプリの実行時に変化する変数、データ ソース、その他の動的参照を含まない定数式である必要があります。
• オプション – オプション。 MatchOptions 列挙値を組み合わせたテキスト文字列。 既定では、MatchOptions.Complete が使用されます。 オプション は、変数、データ ソース、またはアプリの実行時に変更されるその他の動的参照を含まない定数数式である必要があります。

MatchAll( Text, Pattern [, Options ] )

• テキスト – 必須。 一致するテキスト文字列。
• パターン – 必須。 テキスト文字列として一致するパターン。 Match列挙型が定義または正規表現を提供する定義済みのパターンを連結します。 パターン は、変数、データ ソース、またはアプリの実行時に変更されるその他の動的参照を含まない定数数式である必要があります。
• オプション – オプション。 MatchOptions 列挙値を組み合わせたテキスト文字列。 既定では、MatchOptions.Complete が使用されます。 オプション は、変数、データ ソース、またはアプリの実行時に変更されるその他の動的参照を含まない定数数式である必要があります。

IsMatch 例

通常文字

アプリに TextInput1 という名前のテキスト入力コントロールがある場合を想像してください。 ユーザーはこのコントロールに値を入力して、データベースに格納します。

ユーザーは、TextInput1 に「Hello world」と入力します。

事前定義済みパターン

正規表現

Match と MatchAll の例

最後の例の詳細をより細かく見てみましょう。 Time 関数を使用してこの文字列を日付/時刻値に変換する場合は、名前付きサブマッチを個別に渡す必要があります。 これを行うには、Matchが返すレコードで With 関数を使用します。

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」に一致するものをすべて検索します。 文字列には 2 つの一致が含まれていますが、MatchAllではなくMatchを使用しているため、最初の文字列のみが返されます。	{ FullMatch: "The", StartMatch: 32 }
MatchAll( pangram, "the" )	パングラム変数に含まれるテキスト文字列で「THE」に一致するものをすべて検索します。 テストでは大文字と小文字が区別されるため、「the」の 2 番目のインスタンスのみが見つかりました。
MatchAll( pangram, "the", IgnoreCase )	パングラム変数に含まれるテキスト文字列で「THE」に一致するものをすべて検索します。 この場合、テストでは大文字と小文字が区別されないため、単語の両方のインスタンスが見つかりました。
MatchAll( pangram, "\b\wo\w\b" )	中央に "o" がある 3 文字の単語をすべて検索します。 "brown" は 3 文字の単語ではないため除外されるため、"\b" (単語の境界) に一致しません。
Match( pangram, "\b\wo\w\b\s\*(?<between>\w.+\w)\s\*\b\wo\w\b" )	「fox」と「dog」の間のすべての文字に一致します。	{ between:"jumpsoverthelazy"、 FullMatch: "fox jumps over the lazy dog"、 StartMatch: 17 }

ギャラリーで MatchAll の結果を表示するには:

1. 空の画面で、空の垂直 ギャラリー コントロールを挿入します。

2. ギャラリーの Items プロパティを MatchAll( pangram, "\w+" ) または MatchAll( pangram, MultipleLetters ) に設定します。

   

3. ギャラリーのテンプレートを選択するため、ギャラリー コントロールの中央にある「挿入タブからアイテムを追加」を選択します。

4. Label コントロールをギャリーのテンプレートに追加します。

5. ラベルの Text プロパティを ThisItem.FullMatch に設定します。

   ギャラリーは、サンプル テキストの各単語が設定されます。 1 つの画面ですべての単語を表示するには、ギャラリーのテンプレートとラベル コントロールのサイズを変更します。