str_Find函数

函数名：wb_文本查找 / str_Find

函数功能

在原始文本中查找指定内容，并返回首次出现的位置索引（从0开始）。支持设置起始位置及是否区分大小写。

参数规范

参数名	类型	必填	示例	特殊说明
input	String	是	"Hello World"	被搜索的原始文本
searchText	String	是	"world"	要查找的目标子字符串
startIndex	Int	否	0	从哪个索引位置开始查找（默认0）
caseSensitive	Boolean	否	FALSE	是否区分大小写（默认不区分）

使用案例

· 基本查找

问题描述：查找“World”在文本中的位置 公式演示：

=str_Find("Hello World", "World")

输出效果：

6

· 忽略大小写查找

问题描述：查找"excel"在"Excel函数库"中出现的位置（不区分大小写） 公式演示：

=str_Find("Excel函数库", "excel", 0, FALSE)

输出效果：

0

· 区分大小写查找失败

问题描述：因大小写不同而查找失败 公式演示：

=str_Find("Excel函数库", "excel", 0, TRUE)

输出效果：

-1

· 指定起始位置查找

问题描述：从索引4开始查找“l” 公式演示：

=str_Find("Hello World", "l", 4)

输出效果：

9

技术说明

• 返回值为匹配内容首次出现的字符索引（从0开始）
• 当找不到时返回 -1
• 若发生运行异常（如参数越界）则返回 -2
• 不区分大小写时采用 StringComparison.OrdinalIgnoreCase 查找逻辑

异常处理

错误场景	返回值
输入或查找内容为空	-1
查找失败（目标不存在）	-1
参数错误/运行异常	-2

扩展应用

· 判断某关键词是否出现

=str_Find(A1, "错误") >= 0

输出效果：TRUE 或 FALSE

· 提取匹配位置后续内容

=str_Substr(A1, str_Find(A1, "：")+1)

用途：提取"关键字："之后的内容

注：本函数支持在WPS 2019+ 和 Excel 365 环境下稳定运行。中文字符索引与英文一致，适用于中英文混排文本分析。