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