# **CONTAINS**

判断字符串中是否包含子字符串。如果参数**str**中包含子字符串**substr**，则返回 *true* ，否则返回 *false* 。

## 语法{#grammar}

CONTAINS(**str**, **substr**)

- **str**：需要判断的字符串
- **substr**：子字符串

**示例地址：** [CONTAINS](https://demo.succbi.com/v5/bi/contains)

## 示例{#example}

1. `CONTAINS("湖北省武汉市江岸区","武汉")` 查询地址是不是武汉地区，返回`true`
2. `IF(CONTAINS("计算机1603班","03"),"他是三班的")` 返回判断后的信息，返回字符串`他是三班的`
3. `CONTAINS('abcde','ab')` 字符串包含子字符串，返回`true`
4. `CONTAINS('abcde','fd')` 字符串不包含子字符串，返回`false`
5. `CONTAINS('','1')` 字符串为空，返回`false`
6. `CONTAINS('ab cde','b cd')` 字符串包含空格，返回`true`
7. `CONTAINS("ab\tcd","\t")` 字符串含有转义字符，返回`true`
8. `CONTAINS("#$@%!","!")` 字符串为特殊字符，返回`true`
9. `CONTAINS('abcde','')` substr为空，返回`true`，字符串开头结尾是空字符串
10. `CONTAINS('abc','abc')` substr等于原字符串，返回`true`
11. `CONTAINS("abcde",'c'+'d')` substr是表达式，返回`true`
12. `CONTAINS("abcde",'a'|'d')` substr为多个字符串，返回`false`，无法判断多个字串的情况
13. `CONTAINS('','')` str和substr都为空，返回`true`
14. `CONTAINS(A1.[标题],"毛衣")` 引用单元格，判断`A1`的款式是否为毛衣
15. `CONTAINS([门店销售明细表].[款式组合].[款式组合名称],"毛衣")` 引用模型字段，判断款式是否为毛衣