文档首页/ 数据湖探索 DLI/ Spark SQL语法参考/ 内置函数/ 字符串函数/ instr
更新时间：2025-03-21 GMT+08:00
查看PDF
分享

instr

instr函数用于返回substr在str中最早出现的下标。

当参数中出现NULL时，返回NULL，当str中不存在substr时返回0，注意下标从1开始。

相似函数：instr1，instr1函数用于计算子串str2在字符串str1中的位置，instr1函数支持指定起始搜索位置和匹配次数。

命令格式

instr(string <str>, string <substr>)

参数说明

表1 参数说明

参数

是否必选

参数类型

说明

str

是

STRING

待搜索的目标字符串。

如果输入为BIGINT、DOUBLE、DECIMAL或DATETIME类型，则会隐式转换为STRING类型后参与运算，其他类型会返回报错。

substr

是

STRING

待匹配的子串。

如果输入为BIGINT、DOUBLE、DECIMAL或DATETIME类型，则会隐式转换为STRING类型后参与运算，其他类型会返回报错。

返回值说明

返回BIGINT类型的值。

  • 如果在str1中未找到str2，则返回0。
  • 如果str2为空串，则总能匹配成功，例如select instr('abc','');会返回1。
  • str1或str2值为NULL时，返回NULL。

示例代码

  • 计算字符b在字符串abc中的位置。命令示例如下。

    返回2。

    select instr('abc', 'b');
  • 任一输入参数为NULL。命令示例如下。

    返回NULL。

    select instr('abc', null)
父主题： 字符串函数

相关文档