IsMatch、Match、および MatchAll 関数

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

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

内容

IsMatch 関数は、通常文字、事前定義済みのパターン、または正規表現 が含まれたパターンにテキスト文字列が一致するかどうかをテストします。 Match および MatchAll 関数は、サブマッチを含め、一致したものを返します。

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

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

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

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

• これらの関数は、大文字と小文字を区別する一致を実行します。 大文字と小文字を区別しない照合を実行するには MatchOptions.IgnoreCase を使用します。
• IsMatch はテキスト文字列全体に一致します (Complete MatchOption)。一方、 Match と MatchAll はテキスト文字列内の任意の場所に一致するものを検索します (Contains MatchOption)。 シナリオに応じて完了、含む、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」の大文字と小文字が間違っているため、パターンに一致しません。 (この動作を変更する方法に関しては、MatchOptions を参照してください。)

パターンの言語では、特定の文字は特別な目的で予約済みです。 これらの文字を使用するには、接頭辞に \ (バックスラッシュ) を付けた文字が文字どおりに解釈されるようにするか、このトピックの後で定義されている定義済みのいずれかのパターンを使用します。 このテーブルは、特殊文字の一覧を示します:

たとえば、「Hello？」と一致させることができます。パターンを使うことで "Hello\?" 疑問符の前にバックスラッシュを付けます。

事前定義済みパターン

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

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

正規表現

これらの関数が使用するパターンは正規表現 です。 このトピックの前半に定義された、通常文字および事前定義済みのパターンは、正規表現の構築に役立ちます。

正規表現は非常に強力で、多数のプログラミング言語で使用可能であり、さまざまな目的で使用されています。 また、ランダムな一連の句読点のように見えることもあります。 この記事では、正規表現のすべての点について説明していませんが、役に立つ貴重な情報、チュートリアル、およびツールが Web 上で使用可能です。

正規表現にはさまざまな方言があり、Power Apps では JavaScript の方言のバリアントを使用します。 構文の紹介に関しては、正規表現の構文 を参照します。 名前付きサブマッチ (名前付きキャプチャ グループと呼ばれることもあります) がサポートされています:

• 名前付きサブマッチ: (?<name> ...)
• 名前付き後方参照: \k<name>

このトピックの前半の Match 列挙型テーブルでは、各列挙型は、対応する正規表現と同じ行に表示されます。

Match オプション

これらの関数の動作は、1 つ以上のオプションを指定して変更することができます。これらのオプションは文字列連結演算子 (&) を使用して組み合わせることができます。

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

構文

IsMatch( テキスト, パターン [, オプション ] )

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

一致( テキスト, パターン [, オプション ])

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

すべて一致( テキスト, パターン [, オプション ] )

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

IsMatch の例

通常文字

アプリは TextInput1 という名前の Text input コントロールが含まれていると想像します。 ユーザーはデータベースに格納されるために、このコントロールに値を入力します。

ユーザーは 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 を使用しているため、最初の一致のみが返されます。 サブマッチが定義されていないため、SubMatches 列は空です。	{ FullMatch: "The", SubMatches: [ ]、 StartMatch: 32 }
MatchAll( pangram, "the" )	パングラム変数に含まれるテキスト文字列で「THE」に一致するものをすべて検索します。 テストでは大文字と小文字が区別されるため、「the」の 2 番目のインスタンスのみが見つかりました。 サブマッチが定義されていないため、SubMatches 列は空です。
MatchAll( pangram, "the", IgnoreCase )	パングラム変数に含まれるテキスト文字列で「THE」に一致するものをすべて検索します。 この場合、テストでは大文字と小文字が区別されないため、単語の両方のインスタンスが見つかりました。 サブマッチが定義されていないため、SubMatches 列は空です。
MatchAll( pangram, "\b\wo\w\b" )	中央に "o" がある 3 文字の単語をすべて検索します。 「茶色」は 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"、 SubMatches: [ "jumps over the lazy" ], StartMatch: 17 }

ギャラリーで MatchAll の結果を参照:

1. 空の画面で、空白の垂直のGallery コントロールを挿入します。

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

   

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

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

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

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