startsWith

startsWith は、式が指定した部分文字列で始まるかどうかを評価します。式が部分文字列で始まる場合、startsWith は true を返し、それ以外の場合は false を返します。

構文

startsWith(expression, substring, string-comparison-mode)

引数

expression

expression は文字列である必要があります。文字列データ型を使用しているフィールドの名前、'12 Main Street' のようなリテラル値、または文字列を出力する別の関数の呼び出しを使用できます。

substring

式と照合する文字のセット。部分文字列は式の中で複数回出現することがあります。

string-comparison-mode

(オプション) 文字列比較モードを指定し、以下を使用します。

• 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 関数は、次の If 関数内の条件ステートメントとして使用できます: avgIf、minIf、 distinct_countIf、countIf、maxIf、medianIf、、stdevIf、stdevpIfsumIfvarIf、、varpIf。

次の例は、state_nm が New で始まっている場合にのみ Sales が合計されます。

sumIf(Sales,startsWith(state_nm, "New"))

例NOTが含まれています

条件 NOT 演算子を使用して、式が指定された部分文字列で始まらないかどうかを評価できます。

NOT(startsWith(state_nm, "New"))

数値を使用した例

toString 関数を適用することで、式または部分文字列引数に数値を使用できます。

startsWith(state_nm, toString(5) )