# **FIND**

返回一个字符串在另一个字符串中首次出现的位置，从前向后检索。参数 **str** 中的字符位置是从`1`开始的，如果要检索的字符串值没有出现，则返回`0`，查找时区分大小写。

## 语法{#grammar}

FIND(**str**, **find\_value**, **\[start\_index]**)

- **str**：需要检索的字符串
- **find\_value**：需要检索的字符串值
- **start\_index**：可选的非负整数。规定在字符串中开始检索的位置。它的合法取值是 `1` 到 `LEN()`。如省略该参数，则将从字符串的首字符开始检索

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

## 示例{#example}

1. `FIND('abcad','a')` 检索字符串首次出现的位置，返回数值`1`
2. `FIND('abcbcd','c',2)` 从位置2开始查找，返回数值`3`
3. `FIND('abcd','A')` 查找有大小写区分，找不到返回数值`0`
4. `FIND('12311','11')` 参数为数字字符，返回数值`4`
5. `FIND('这是武汉中心','中')` 参数为中文字符，返回数值`5`
6. `FIND(' 2 1','1')` 参数含空格，返回数值`4`，一个空格占一个位置
7. `FIND('#$%&!.','%')` 参数为特殊字符，返回数值`3`
8. `FIND("a\t\nb",'b')` 参数含转义字符，返回数值`4`，转义字符占一个位置
9. `FIND('',2)` 参数为空字符串，返回数值`0`
10. `FIND('123','')` `find_value`为空字符串，返回`0`
11. `FIND(A1,'(','2')` 引用单元格，返回`A1`中`(`的位置
12. `FIND([门店销售明细表].[门店].[门店名称],'(','2')` 引用模型字段，返回`(`的位置