# Matches

文字列が正規表現に一致しているかどうかをチェックします。

この関数によりブール値が返されます。

## 関連する例

* [正規表現の一致に基づいて値を返す](https://help.qlik.com/talend/ja-JP/data-mapper-functions-reference-guide/8.0/returning-values-based-on-regular-expressions-matches)

## 引数

| 引数 | 定義 |
| --- | --- |
| Input Value | チェックする値を指定します。 |

## [Properties] (プロパティ)

| [Properties] (プロパティ) | 定義 |
| --- | --- |
| Regex Value | 使用する正規表現を指定します。<br><br>この構文はW3 XML Schemaの正規表現構文に基づいています。サポートされている項目は次のとおりです。<br><br><ul> <li> <span>^</span>と<span>$</span>: 入力文字列の先頭と末尾、または入力中の各行の先頭と末尾にそれぞれ一致させるために使います。</li> <li>キャプチャーされた副次式</li> <li>後方参照</li> <li>Unicodeブロック名</li> </ul><br><br>詳細は、[W3Cのドキュメンテーション](https://www.w3.org/TR/xpath-functions-31/#regex-syntax) (英語のみ)をご覧ください。<br><br>このプロパティは引数としても使用できます。両方を指定すると、引数値が使用され、プロパティ値は無視されます。 |
| Case sensitive | 大文字と小文字を区別して一致させたい場合は、このチェックボックスをオンにします。 |
| Ignore white space | 正規表現にあるホワイトスペース文字を無視する場合は、このチェックボックスをオンにします。これは、長い正規表現を作成していて、読みやすいように複数の行に分割する場合に便利です。<br><br>たとえば[Ignore white space] (ホワイトスペースを無視)オプションが有効になっている場合、Main Streetという正規表現は次の値とは一致しなくなります:<br><br>```<br><press>123 Main Street<br>Traverse City, MI 49684</press><br>```<br><br>一致させるためには、Main\sStreetを使う必要があります。 |
| Single Line | 入力値に改行が含まれていても1行として処理したい場合は、このチェックボックスをオンにします。次の点にご注意ください。<br><br><ul> <li><span>.</span>という文字は、改行を含めてすべての文字と一致します。</li> <li><span>^</span>という文字は文字列全体の先頭にのみ、<span>$</span>という文字は文字列全体の末尾にのみ一致します。</li> </ul><br><br>たとえば[Single Line] (単一行)オプションが有効になっている場合、Street$\n^Traverseという正規表現は次の値とは一致しなくなります:<br><br>```<br><press>123 Main Street<br>Traverse City, MI 49684</press><br>```<br><br>ただし、Street\nTraverseやStreet.\*Traverseは一致します。 |