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) )