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

locate

locate函数用于在str中查找substr的位置。您可以通过start_pos指定开始查找的位置，从1开始计数。

命令格式

locate(string <substr>, string <str>[, bigint <start_pos>])

参数说明

表1 参数说明

参数

是否必选

参数类型

说明

str

是

STRING

待搜索的目标字符串。

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

substr

是

STRING

待匹配的子串。

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

start_pos

否

BIGINT

指定查找的起始位置。

返回值说明

返回为BIGINT类型。

  • str中无法匹配到substr时，返回0。
  • str或substr值为NULL时，返回NULL。
  • start_pos值为NULL时，返回0。

示例代码

  • 查找字符串ab在字符串abhiab中的位置。命令示例如下。

    返回1。

    select locate('ab', 'abhiab');

    返回5。

    select locate('ab', 'abhiab', 2);

    返回0。

    select locate('ab', 'abhiab', null);
  • 查找字符串hi在字符串hanmeimei and lilei中的位置。命令示例如下。

    返回0。

    select locate('hi', 'hanmeimei and lilei');
父主题： 字符串函数