翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
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、、medianIfstdevIf、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
) )