指定の文字列に指定のパターン文字列があるかどうかを判断します。パターン文字列には多数の「ワイルドカード」文字や論理記号を使用できるため、複雑な文字パターンを照合できます。

構文

@Matches( string ; pattern )

パラメータ

string

文字列または文字列リスト。検索対象の文字列を引用符で囲んで指定します。検索対象の文字列が含まれているフィールドの名前を入力することもできます。フィールド名は引用符で囲まないでください。

文字列または文字列リスト。string 内で検索するパターンを引用符で囲んで指定します。ワイルドカード文字と記号を使用することもできます (下表参照)。検索するパターンがセットとして中カッコ ({ }) で囲まれている場合を除き、?、*、&、!、|、\、+ の記号の前に円記号を付ける必要があります。パターンをリテラルとして指定する場合は、記号の前に円記号を 1 つではなく 2 つ付ける必要があります。円記号は文字列リテラルではエスケープ文字であるため、「\?」と指定すると照合エンジンには「?」が渡され、ワイルドカードとして処理されます。「\\?」と指定すると照合エンジンには「\?」が渡され、疑問符文字として処理されます。

メモ パターン内の単純な文字は、大文字と小文字が区別されません。中カッコで囲まれた文字は、正確に一致する必要があり、大文字と小文字が区別されます。文字セット {A-z} には、大文字と小文字のアルファベットだけでなく、円記号、アンダースコア、および角カッコの文字が含まれます。

flag

Boolean 型
• 指定したパターンが文字列内にある場合は 1 (True) が返されます。
• 指定したパターンが文字列内にない場合は 0 (False) が返されます。

パターン一致の例を示します。

パターン	一致
ABC	3 文字の文字列 [a|A][b|B][c|C]。
{ABC}{ABC}	大文字 A、B、または C からなる 2 文字の文字列
A?C	a または A で始まり c または C で終わる、任意の3 文字の文字列
???	任意の 3 文字の文字列
+?	Null 文字列を含む任意の文字列
+?{A-Z}	大文字で終了する任意の文字列
+{!A-Z}	大文字を含まない任意の文字列

使用法

最初または 2 番目のパラメータがリストである場合、2 番目のパラメータ内のいずれかの要素が最初のパラメータ内のいずれかの要素と一致すると、この関数は true を返します。

クロスリファレンス

LotusScript 言語の Like 演算子

例
関連項目

連結、比較、長さの判定をする

用語集