字符串函数和运算符¶

本页说明 Polars SQL 中可用的字符串运算符和函数。

字符串运算符¶

|| 运算符执行拼接。NULL 操作数会按空字符串处理。

备注

这些函数假定输入字符串包含有效的 UTF-8 编码 Unicode 码点。函数不会显式检查 UTF-8 是否有效；遇到无效 UTF-8 时，可能返回不正确的结果。

此外，这些函数按 Unicode 码点操作，而不是按用户可见的“字符”或“字素簇”操作。有些语言会将多个码点组合成用户感知的单个“字符”，即该语言书写系统的基本单位；但这些函数会把每个码点视为独立单位。

lower() 和 upper() 函数不会执行某些语言所需的区域敏感、上下文敏感或一对多映射。具体来说，对于立陶宛语、土耳其语和阿塞拜疆语，这会返回不正确的结果。

concat(string1, ..., stringN) -> varchar()¶: 返回 string1、string2、...、stringN 的拼接结果。该函数提供与 SQL 标准拼接运算符（||）相同的功能。NULL 参数会按空字符串处理。

replace(string, search, replace) -> varchar()¶

将 string 中所有 search 替换为 replace。

如果 search 为空字符串，则在每个字符前以及 string 末尾插入 replace。

substr(string, start) -> varchar()¶: 返回 string 中从起始位置 start 开始的剩余部分。位置从 1 开始。当前支持范围为正数位置。

substr(string, start, length) -> varchar()¶: 从 string 的起始位置 start 开始返回长度为 length 的子串。位置从 1 开始。当前支持范围为正数位置。

find(substring, string) -> bigint()¶: 返回 substring 在 string 中从 1 开始计数的位置；如果未找到该子串，则返回 0。

find(substring, string, start) -> bigint(): 从 1 开始计数的位置 start 起，返回 substring 在 string 中从 1 开始计数的位置；如果未找到该子串，则返回 0。

trim(string) -> varchar()¶

移除 string 开头和末尾的 SQL 空白字符。

可识别的空白字符：