本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
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) )
