本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
startsWith
會評估表達式是否以您指定的子字串開頭。如果表達式以相應子字符串開頭,則 startsWith
會返回 true,否則會返回 false。
語法
startsWith(
expression
,substring
,string-comparison-mode
)
引數
- 運算式
-
表達式必須是字串。它可以是使用字串資料類型的欄位、
'12 Main Street'
之類的常值,或對輸出字串的另一個函數的呼叫。 - substring
-
要針對表達式檢查的字元集。該子字串在表達式中可能出現一或多次。
- string-comparison-mode
-
(選用) 指定要使用的字串比較模式:
-
CASE_SENSITIVE
:字串比較區分大小寫。 -
CASE_INSENSITIVE
:字串比較不區分大小寫。
空白時此值會預設為
CASE_SENSITIVE
。 -
傳回類型
Boolean
範例
預設區分大小寫的範例
下列區分大小寫的範例會評估 是否 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、stdevpIf、sumIf、 varIf和 varpIf。
以下範例僅當 state_nm 以 New
開頭時才對 Sales
求和。
sumIf(
Sales
,startsWith(state_nm
,"New"
))
NOT 包含範例
條件 NOT
運算子可用來評估表達式是否以指定的子字串開頭。
NOT(startsWith(
state_nm
,"New"
))
使用數值的範例
透過套用 toString
函數,可以在表達式或子字串引數中使用數值。
startsWith(
state_nm
, toString(5
) )