文本查找

函数名：wb_文本查找 / str_Find

功能描述

在原文本中查找指定内容，返回首次出现的位置索引。索引从 0 开始计数，支持指定起始查找位置和大小写敏感模式。

会员等级：🟢 免费版（Free）

语法

=str_Find(原文本, 查找内容, 起始位置, 区分大小写)

参数

参数名	类型	必填	默认值	说明
原文本	String	是	无	被查找的原始文本
查找内容	String	是	无	要查找的文本
起始位置	Int	否	0	开始查找的位置（从 0 开始）
区分大小写	Boolean	否	FALSE	TRUE=区分大小写，FALSE=不区分

返回值

Int - 查找内容首次出现的 0 基索引位置。未找到返回 -1，发生异常返回 -2。

使用示例

基本查找

公式：

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

结果：

6

从指定位置开始查找

公式：

=str_Find("abcabc", "abc", 1)

结果：

3

区分大小写查找

公式：

=str_Find("Excel excel", "Excel", 0, TRUE)

结果：

0

技术说明

• 内部调用 string.IndexOf 方法，根据 区分大小写 参数选择比较模式：
  • 区分大小写：StringComparison.Ordinal（基于 Unicode 码点的序号比较）
  • 不区分大小写：StringComparison.OrdinalIgnoreCase
• 返回值为 0 基索引（第一个字符位置为 0），与 Excel 内置 FIND 函数的 1 基索引不同
• 空字符串输入直接返回 -1

错误处理

错误场景	返回值
原文本或查找内容为空/null	-1
未找到查找内容	-1
起始位置越界等异常	-2