BYTES_SUBSTRING
返回输入值的子字符串,使用 UTF-8 编码字节表示形式的字节偏移量。不完整的字符和无效的 UTF-8 码点将从结果中移除。
语法
使用以下语法在您的查询中包含 BYTES_SUBSTRING 函数:
BYTES_SUBSTRING(value, startIndex, endIndex)
参数
BYTES_SUBSTRING 函数需要以下参数:
value输入是您要对其执行子字符串函数的字符串。startIndex从1开始,并包含字符串中的第一个字符。endIndex从字符串中的第一个字符开始计数,而不是从startIndex位置开始。
| 名称 | 类型 | 描述 | 默认值 |
|---|---|---|---|
| 值 | 字符串 | 要对其执行子字符串函数的输入值 | |
| startIndex | int | 包含的起始字节索引 | |
| endIndex | int | 不包含的结束字节索引 |
返回
返回一个 string 值。
示例
以下示例展示了 startIndex 和 endIndex 参数如何影响 Output 值。此处,endIndex 值表明,无论 startIndex 值如何,endIndex 都从字符串中的位置 1 开始,包含 10 个字符。
| 值 | startIndex | endIndex | 输出 |
|---|---|---|---|
| '你好世界' | 1 | 10 | `Hello Worl` |
| '你好世界' | 2 | 10 | `ello Worl` |
| '⻤Hello Wor⻤' | 2 | 10 | `Hello W` |
| '⻤Hello Wor⻤' | 1 | 10 | `⻤Hello W` |
| 'Hello' | 1 | 10 | `Hello` |