contains
contains は、指定した部分文字列が式内に存在するかどうかを判断します。式に部分文字列が含まれている場合、contains は true を返し、それ以外の場合は false を返します。
構文
contains(expression,substring,string-comparison-mode)
引数
- expression
-
expression は文字列である必要があります。文字列データ型を使用しているフィールドの名前、
'12 Main Street'のようなリテラル値、または文字列を出力する別の関数の呼び出しを使用できます。 - substring
-
式と照合する文字のセット。部分文字列は式の中で複数回出現することがあります。
- 文字列比較モード
-
(オプション) 文字列比較モードを指定し、以下を使用します。
-
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 関数は、「avgIf」、「minIf」、「distinct_countIf」、「countIf」、「maxIf」、「medianIf」、「stdevIf」、「stdevpIf」、「sumIf」、「varIf」、「varpIf」の If 関数内の条件ステートメントとして使用できます。
次の例では、state_nm が New を含む場合にのみ Sales が合計されます。
sumIf(Sales,contains(state_nm,"New"))
例は含まれていません
条件 NOT 演算子を使用して、式に指定された部分文字列が含まれていないかどうかを評価できます。
NOT(contains(state_nm,"New"))
数値を使用した例
toString 関数を適用することで、式または部分文字列引数に数値を使用できます。
contains(state_nm, toString(5) )
