大网数据广告活动
数据库部署与 SQL 参考

StarRocks 中文参考:trim

· 52CE 我爱测

从字符串的左侧和右侧移除连续出现的空格或指定的字符。从 2.5.0 版本开始,支持从字符串中移除指定字符。

trim

从字符串的左侧和右侧移除连续出现的空格或指定的字符。从 2.5.0 版本开始,支持从字符串中移除指定字符。

语法

trim(str[,characters]);

参数说明

str: 必选,要裁剪的字符串,支持的数据类型为 VARCHAR。

characters: 可选,要移除的字符,支持的数据类型为 VARCHAR。如果不指定该参数,默认移除空格。如果该参数为空字符,返回报错。

返回值说明

返回值的数据类型为 VARCHAR。

示例

示例一:移除字符串左侧和右侧共 5 个空格。

MySQL > SELECT trim("   ab c  ");
+-------------------+
| trim('   ab c  ') |
+-------------------+
| ab c              |
+-------------------+

示例二:移除字符串中左侧和右侧的指定字符。

MySQL > SELECT trim("abcd", "ad");
+--------------------+
| trim('abcd', 'ad') |
+--------------------+
| bc                 |
+--------------------+

MySQL > SELECT trim("xxabcdxx", "x");
+-----------------------+
| trim('xxabcdxx', 'x') |
+-----------------------+
| abcd                  |
+-----------------------+

兼容 MySQL 的 TRIM(... FROM ...) 语法

除了 trim(str) 和 trim(str, characters),StarRocks 还支持 MySQL/SQL 标准的写法:

TRIM([{BOTH | LEADING | TRAILING}] [remstr] FROM str)
  • BOTH(省略说明符时的默认值)裁剪两端;LEADING 仅裁剪开头;TRAILING 仅裁剪结尾。
  • remstr 为可选的字符串字面量。若省略,则裁剪空格。
  • remstr 作为一个完整的子串被反复移除,而不是被当作字符集合。这一点与 trim(str, characters) 不同,后者的第二个参数是字符集合。
MySQL > SELECT TRIM(LEADING 'x' FROM 'xxxbarxxx');
+------------------------------------+
| TRIM(LEADING 'x' FROM 'xxxbarxxx') |
+------------------------------------+
| barxxx                             |
+------------------------------------+

MySQL > SELECT TRIM(TRAILING 'xyz' FROM 'barxxyzxyz');
+----------------------------------------+
| TRIM(TRAILING 'xyz' FROM 'barxxyzxyz') |
+----------------------------------------+
| barx                                   |
+----------------------------------------+

MySQL > SELECT TRIM(BOTH 'ab' FROM 'abfooab');
+--------------------------------+
| TRIM(BOTH 'ab' FROM 'abfooab') |
+--------------------------------+
| foo                            |
+--------------------------------+

注意子串(FROM)写法与字符集合(逗号)写法的区别:

-- 子串:将完整的 'xyz' 移除一次,得到 'barx'
MySQL > SELECT TRIM(TRAILING 'xyz' FROM 'barxxyz');  -- 'barx'

-- 字符集合:移除结尾处任意的 x/y/z,得到 'bar'
MySQL > SELECT rtrim('barxxyz', 'xyz');              -- 'bar'

FROM 写法由内置函数 trim_string(str, remstr)、ltrim_string(str, remstr)、rtrim_string(str, remstr) 实现,这些函数也可直接调用。remstr 必须为常量字符串字面量。

注意

remstr 不能为 NULL。向这些内置函数传入 NULL 的 remstr(例如 trim_string('abc', CAST(NULL AS STRING)))会返回错误而非 NULL。这与逗号写法 trim(str, characters) 的行为一致,但与 MySQL 不同(MySQL 返回 NULL)。str 为 NULL 时仍会传播为 NULL(例如 TRIM('x' FROM NULL) 返回 NULL)。

相关文档

本文来自 StarRocks 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
StarRocks 文档贡献者
适用范围
main 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。