CONTAINS関数は、最初の文字列式に 2 番目の文字列式が含まれているかどうかを示すブール値を返します。
構文
CONTAINS(<string_expr_1>, <string_expr_2> [, <bool_expr>])
論争
| Description | |
|---|---|
string_expr_1 |
検索する最初の文字列。 |
string_expr_2 |
検索する 2 番目の文字列。 |
bool_expr |
大文字と小文字を区別する省略可能なブール値。
trueに設定すると、CONTAINSは大文字と小文字を区別しない検索を実行します。
unspecifiedすると、この値の既定値は false になります。 |
戻り値の型
ブール式を返します。
例示
このセクションでは、このクエリ言語コンストラクトを使用する方法の例を示します。
文字列の例が含まれています
この例では、 CONTAINS 関数を使用して、文字列内の部分文字列をチェックします。
SELECT VALUE {
containsPrefix: CONTAINS("AdventureWorks", "Adventure"),
containsSuffix: CONTAINS("AdventureWorks", "Works"),
containsWrongCase: CONTAINS("AdventureWorks", "adventure"),
containsWrongCaseValidateCase: CONTAINS("AdventureWorks", "adventure", false),
containsWrongCaseIgnoreCase: CONTAINS("AdventureWorks", "works", true),
containsMismatch: CONTAINS("AdventureWorks", "Contoso")
}
[
{
"containsPrefix": true,
"containsSuffix": true,
"containsWrongCase": false,
"containsWrongCaseValidateCase": false,
"containsWrongCaseIgnoreCase": true,
"containsMismatch": false
}
]
注釈
- この関数はフル スキャンを実行します。