翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
contains
contains
は、指定した部分文字列が式内に存在するかどうかを判断します。式に部分文字列が含まれている場合、contains は true を返し、それ以外の場合は false を返します。
構文
contains(
expression
,substring
,string-comparison-mode
)
引数
- expression
-
expression は文字列である必要があります。文字列データ型を使用しているフィールドの名前、
'12 Main Street'
のようなリテラル値、または文字列を出力する別の関数の呼び出しを使用できます。 - substring
-
式と照合する文字のセット。部分文字列は式の中で複数回出現することがあります。
- string-comparison-mode
-
(オプション) 文字列比較モードを指定し、以下を使用します。
-
CASE_SENSITIVE
– 文字列比較では、大文字と小文字が区別されます。 -
CASE_INSENSITIVE
– 文字列比較では、大文字と小文字が区別されません。
空白の場合、この値はデフォルトで
CASE_SENSITIVE
です。 -
戻り型
ブール値
例
デフォルトの大文字と小文字を区別した例
次の例では大文字と小文字を区別し、state_nm
が New
を含めるかどうかを評価します。
contains(
state_nm
,"New"
)
次が指定したフィールド値です。
New York new york
これらのフィールド値に対して、以下の値が返されます。
true false
大文字と小文字を区別しない例
次の例では大文字と小文字を区別せず、state_nm
が new
を含めるかどうかを評価します。
contains(
state_nm
,"new"
, CASE_INSENSITIVE)
次が指定したフィールド値です。
New York new york
これらのフィールド値に対して、以下の値が返されます。
true true
条件ステートメントの例
contains 関数は、、、 distinct_countIfavgIf、、、、minIf、countIf、maxIf、medianIfstdevIfstdevpIfsumIfvarIf、および の If 関数内の条件ステートメントとして使用できますvarpIf。
次の例では、state_nm
が New
を含む場合にのみ Sales
が合計されます。
sumIf(
Sales
,contains(state_nm
,"New"
))
例NOTが含まれています
条件 NOT
演算子を使用して、式に指定された部分文字列が含まれていないかどうかを評価できます。
NOT(contains(
state_nm
,"New"
))
数値を使用した例
toString
関数を適用することで、式または部分文字列引数に数値を使用できます。
contains(
state_nm
, toString(5
) )