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