contains
contains
评估您指定的子字符串是否存在于表达式中。如果表达式包含子字符串,则返回 true,否则返回 false。
语法
contains(
expression
,substring
,string-comparison-mode
)
Arguments
- expression
-
表达式必须是字符串。它可以是使用字符串数据类型的字段的名称、文本值(如
'12 Main Street'
)或对输出字符串的其他函数的调用。 - substring
-
要根据表达式检查的字符集。子字符串可在表达式中出现一次或多次。
- string-comparison-mode
-
(可选)指定要使用的字符串比较模式:
-
CASE_SENSITIVE
– 字符串比较区分大小写。 -
CASE_INSENSITIVE
– 字符串比较不区分大小写。
留空时此值默认为
CASE_SENSITIVE
。 -
返回类型
布尔值
示例
默认区分大小写的示例
以下区分大小写的示例评估 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
带条件语句的示例
包含函数可用作以下 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
) )