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

length

length函数用于返回字符串的长度。

相似函数：lengthb，lengthb函数用于计算字符串str以字节为单位的长度，返回STRING类型的值。

命令格式

length(string <str>)

参数说明

表1 参数说明

参数

是否必选

参数类型

说明

str

是

STRING

待搜索的目标字符串。

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

返回值说明

返回BIGINT类型的值。

  • str非STRING、BIGINT、DOUBLE、DECIMAL或DATETIME类型时，返回报错。
  • str值为NULL时，返回NULL。

示例代码

  • 计算字符串abc的长度。命令示例如下。

    返回3。

    select length('abc');
  • 输入参数为NULL。命令示例如下。

    返回NULL。

    select length(null);
父主题： 字符串函数