This is an automated email from the ASF dual-hosted git repository.
qiaojialin pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/iotdb-docs.git
The following commit(s) were added to refs/heads/main by this push:
new 3515a8d3 fix basic function concat in table model (#630)
3515a8d3 is described below
commit 3515a8d3504d7eff9fecaccb4d2725c869fd0468
Author: leto-b <[email protected]>
AuthorDate: Wed Mar 5 18:19:01 2025 +0800
fix basic function concat in table model (#630)
---
.../Master/Table/SQL-Manual/Basis-Function.md | 30 +++++++++++-----------
.../latest-Table/SQL-Manual/Basis-Function.md | 30 +++++++++++-----------
.../Master/Table/SQL-Manual/Basis-Function.md | 30 +++++++++++-----------
.../latest-Table/SQL-Manual/Basis-Function.md | 30 +++++++++++-----------
4 files changed, 60 insertions(+), 60 deletions(-)
diff --git a/src/UserGuide/Master/Table/SQL-Manual/Basis-Function.md
b/src/UserGuide/Master/Table/SQL-Manual/Basis-Function.md
index 6dfbac12..a56825fa 100644
--- a/src/UserGuide/Master/Table/SQL-Manual/Basis-Function.md
+++ b/src/UserGuide/Master/Table/SQL-Manual/Basis-Function.md
@@ -772,21 +772,21 @@ The `||` operator is used for string concatenation and
functions the same as the
### 8.2 String Functions
-| Function Name | Description
| Input | Output |
Usage |
-| :------------ | :-----------------------------------------------------------
| :----------------------------------------------------------- | :------ |
:----------------------------------------------------------- |
-| `length` | Returns the number of characters in a string (not byte
length). | `string` (the string whose length is to be calculated) | INT32
| length(string) |
-| `upper` | Converts all letters in a string to uppercase.
| string | String |
upper(string) |
-| `lower` | Converts all letters in a string to lowercase.
| string | String |
lower(string) |
-| `trim` | Removes specified leading and/or trailing characters from a
string. **Parameters:** - `specification` (optional): Specifies which side to
trim: - `BOTH`: Removes characters from both sides (default). -
`LEADING`: Removes characters from the beginning. - `TRAILING`: Removes
characters from the end. - `trimcharacter` (optional): Character to be removed
(default is whitespace). - `string`: The target string. | string
[...]
-| `strpos` | Returns the position of the first occurrence of `subStr` in
`sourceStr`. **Notes:** - Position starts at `1`. - Returns `0` if `subStr`
is not found. - Positioning is based on characters, not byte arrays. |
`sourceStr` (string to be searched), `subStr` (substring to find) | INT32 |
strpos(sourceStr, subStr) |
-| `starts_with` | Checks if `sourceStr` starts with the specified `prefix`.
| `sourceStr`, `prefix` | Boolean |
starts_with(sourceStr, prefix) |
-| `ends_with` | Checks if `sourceStr` ends with the specified `suffix`.
| `sourceStr`, `suffix` | Boolean |
ends_with(sourceStr, suffix) |
-| `concat` | Concatenates `string1, string2, ..., stringN`. Equivalent to
the `||` operator. | `string`, `text`
| String | concat(str1, str2, ...) or str1 \|\| str2 ... |
-| `strcmp` | Compares two strings lexicographically. **Returns:** -
`-1` if `str1 < str2` - `0` if `str1 = str2` - `1` if `str1 > str2` - `NULL`
if either `str1` or `str2` is `NULL` | `string1`, `string2`
| INT32 | strcmp(str1, str2)
|
-| `replace` | Removes all occurrences of `search` in `string`.
| `string`, `search` | String |
replace(string, search) |
-| `replace` | Replaces all occurrences of `search` in `string` with
`replace`. | `string`, `search`, `replace` |
String | replace(string, search, replace) |
-| `substring` | Extracts a substring from `start_index` to the end of the
string. **Notes:** - `start_index` starts at `1`. - Returns `NULL` if input
is `NULL`. - Throws an error if `start_index` is greater than string length. |
`string`, `start_index` | String |
substring(string from start_index)or substring(string, start_index) |
-| `substring` | Extracts a substring of `length` characters starting from
`start_index`. **Notes:** - `start_index` starts at `1`. - Returns `NULL` if
input is `NULL`. - Throws an error if `start_index` is greater than string
length. - Throws an error if `length` is negative. - If `start_index +
length` exceeds `int.MAX`, an overflow error may occur. | `string`,
`start_index`, `length` | String | substring(string
from start_index for length) or substri [...]
+| Function Name | Description
| Input
[...]
+| :------------
|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:-----------------------------------------------
[...]
+| `length` | Returns the number of characters in a string (not byte
length).
| `string` (the string whose
length is to be calc [...]
+| `upper` | Converts all letters in a string to uppercase.
| string
[...]
+| `lower` | Converts all letters in a string to lowercase.
| string
[...]
+| `trim` | Removes specified leading and/or trailing characters from a
string. **Parameters:** - `specification` (optional): Specifies which side to
trim: - `BOTH`: Removes characters from both sides (default). -
`LEADING`: Removes characters from the beginning. - `TRAILING`: Removes
characters from the end. - `trimcharacter` (optional): Character to be removed
(default is whitespace). - `string`: The target string. | string
[...]
+| `strpos` | Returns the position of the first occurrence of `subStr` in
`sourceStr`. **Notes:** - Position starts at `1`. - Returns `0` if `subStr`
is not found. - Positioning is based on characters, not byte arrays.
| `sourceStr` (string to be
searched), `subStr` ( [...]
+| `starts_with` | Checks if `sourceStr` starts with the specified `prefix`.
| `sourceStr`, `prefix`
[...]
+| `ends_with` | Checks if `sourceStr` ends with the specified `suffix`.
| `sourceStr`, `suffix`
[...]
+| `concat` | Concatenates `string1, string2, ..., stringN`. Equivalent to
the `\|\|` operator.
| `string`, `text`
[...]
+| `strcmp` | Compares two strings lexicographically. **Returns:** -
`-1` if `str1 < str2` - `0` if `str1 = str2` - `1` if `str1 > str2` - `NULL`
if either `str1` or `str2` is `NULL`
| `string1`, `string2`
[...]
+| `replace` | Removes all occurrences of `search` in `string`.
| `string`, `search`
[...]
+| `replace` | Replaces all occurrences of `search` in `string` with
`replace`.
| `string`, `search`,
`replace` [...]
+| `substring` | Extracts a substring from `start_index` to the end of the
string. **Notes:** - `start_index` starts at `1`. - Returns `NULL` if input
is `NULL`. - Throws an error if `start_index` is greater than string length.
| `string`, `start_index`
[...]
+| `substring` | Extracts a substring of `length` characters starting from
`start_index`. **Notes:** - `start_index` starts at `1`. - Returns `NULL` if
input is `NULL`. - Throws an error if `start_index` is greater than string
length. - Throws an error if `length` is negative. - If `start_index +
length` exceeds `int.MAX`, an overflow error may occur.
| `string`,
`start_index`, `length` [...]
## 9. Pattern Matching Functions
diff --git a/src/UserGuide/latest-Table/SQL-Manual/Basis-Function.md
b/src/UserGuide/latest-Table/SQL-Manual/Basis-Function.md
index 6dfbac12..a56825fa 100644
--- a/src/UserGuide/latest-Table/SQL-Manual/Basis-Function.md
+++ b/src/UserGuide/latest-Table/SQL-Manual/Basis-Function.md
@@ -772,21 +772,21 @@ The `||` operator is used for string concatenation and
functions the same as the
### 8.2 String Functions
-| Function Name | Description
| Input | Output |
Usage |
-| :------------ | :-----------------------------------------------------------
| :----------------------------------------------------------- | :------ |
:----------------------------------------------------------- |
-| `length` | Returns the number of characters in a string (not byte
length). | `string` (the string whose length is to be calculated) | INT32
| length(string) |
-| `upper` | Converts all letters in a string to uppercase.
| string | String |
upper(string) |
-| `lower` | Converts all letters in a string to lowercase.
| string | String |
lower(string) |
-| `trim` | Removes specified leading and/or trailing characters from a
string. **Parameters:** - `specification` (optional): Specifies which side to
trim: - `BOTH`: Removes characters from both sides (default). -
`LEADING`: Removes characters from the beginning. - `TRAILING`: Removes
characters from the end. - `trimcharacter` (optional): Character to be removed
(default is whitespace). - `string`: The target string. | string
[...]
-| `strpos` | Returns the position of the first occurrence of `subStr` in
`sourceStr`. **Notes:** - Position starts at `1`. - Returns `0` if `subStr`
is not found. - Positioning is based on characters, not byte arrays. |
`sourceStr` (string to be searched), `subStr` (substring to find) | INT32 |
strpos(sourceStr, subStr) |
-| `starts_with` | Checks if `sourceStr` starts with the specified `prefix`.
| `sourceStr`, `prefix` | Boolean |
starts_with(sourceStr, prefix) |
-| `ends_with` | Checks if `sourceStr` ends with the specified `suffix`.
| `sourceStr`, `suffix` | Boolean |
ends_with(sourceStr, suffix) |
-| `concat` | Concatenates `string1, string2, ..., stringN`. Equivalent to
the `||` operator. | `string`, `text`
| String | concat(str1, str2, ...) or str1 \|\| str2 ... |
-| `strcmp` | Compares two strings lexicographically. **Returns:** -
`-1` if `str1 < str2` - `0` if `str1 = str2` - `1` if `str1 > str2` - `NULL`
if either `str1` or `str2` is `NULL` | `string1`, `string2`
| INT32 | strcmp(str1, str2)
|
-| `replace` | Removes all occurrences of `search` in `string`.
| `string`, `search` | String |
replace(string, search) |
-| `replace` | Replaces all occurrences of `search` in `string` with
`replace`. | `string`, `search`, `replace` |
String | replace(string, search, replace) |
-| `substring` | Extracts a substring from `start_index` to the end of the
string. **Notes:** - `start_index` starts at `1`. - Returns `NULL` if input
is `NULL`. - Throws an error if `start_index` is greater than string length. |
`string`, `start_index` | String |
substring(string from start_index)or substring(string, start_index) |
-| `substring` | Extracts a substring of `length` characters starting from
`start_index`. **Notes:** - `start_index` starts at `1`. - Returns `NULL` if
input is `NULL`. - Throws an error if `start_index` is greater than string
length. - Throws an error if `length` is negative. - If `start_index +
length` exceeds `int.MAX`, an overflow error may occur. | `string`,
`start_index`, `length` | String | substring(string
from start_index for length) or substri [...]
+| Function Name | Description
| Input
[...]
+| :------------
|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:-----------------------------------------------
[...]
+| `length` | Returns the number of characters in a string (not byte
length).
| `string` (the string whose
length is to be calc [...]
+| `upper` | Converts all letters in a string to uppercase.
| string
[...]
+| `lower` | Converts all letters in a string to lowercase.
| string
[...]
+| `trim` | Removes specified leading and/or trailing characters from a
string. **Parameters:** - `specification` (optional): Specifies which side to
trim: - `BOTH`: Removes characters from both sides (default). -
`LEADING`: Removes characters from the beginning. - `TRAILING`: Removes
characters from the end. - `trimcharacter` (optional): Character to be removed
(default is whitespace). - `string`: The target string. | string
[...]
+| `strpos` | Returns the position of the first occurrence of `subStr` in
`sourceStr`. **Notes:** - Position starts at `1`. - Returns `0` if `subStr`
is not found. - Positioning is based on characters, not byte arrays.
| `sourceStr` (string to be
searched), `subStr` ( [...]
+| `starts_with` | Checks if `sourceStr` starts with the specified `prefix`.
| `sourceStr`, `prefix`
[...]
+| `ends_with` | Checks if `sourceStr` ends with the specified `suffix`.
| `sourceStr`, `suffix`
[...]
+| `concat` | Concatenates `string1, string2, ..., stringN`. Equivalent to
the `\|\|` operator.
| `string`, `text`
[...]
+| `strcmp` | Compares two strings lexicographically. **Returns:** -
`-1` if `str1 < str2` - `0` if `str1 = str2` - `1` if `str1 > str2` - `NULL`
if either `str1` or `str2` is `NULL`
| `string1`, `string2`
[...]
+| `replace` | Removes all occurrences of `search` in `string`.
| `string`, `search`
[...]
+| `replace` | Replaces all occurrences of `search` in `string` with
`replace`.
| `string`, `search`,
`replace` [...]
+| `substring` | Extracts a substring from `start_index` to the end of the
string. **Notes:** - `start_index` starts at `1`. - Returns `NULL` if input
is `NULL`. - Throws an error if `start_index` is greater than string length.
| `string`, `start_index`
[...]
+| `substring` | Extracts a substring of `length` characters starting from
`start_index`. **Notes:** - `start_index` starts at `1`. - Returns `NULL` if
input is `NULL`. - Throws an error if `start_index` is greater than string
length. - Throws an error if `length` is negative. - If `start_index +
length` exceeds `int.MAX`, an overflow error may occur.
| `string`,
`start_index`, `length` [...]
## 9. Pattern Matching Functions
diff --git a/src/zh/UserGuide/Master/Table/SQL-Manual/Basis-Function.md
b/src/zh/UserGuide/Master/Table/SQL-Manual/Basis-Function.md
index c2d312da..b0ab5ca9 100644
--- a/src/zh/UserGuide/Master/Table/SQL-Manual/Basis-Function.md
+++ b/src/zh/UserGuide/Master/Table/SQL-Manual/Basis-Function.md
@@ -769,21 +769,21 @@ SELECT *
### 8.2 字符串函数
-| 函数名 | 描述 | 输入
| 输出
| 用法
|
-| ----------- | ------------------------------------------------------------ |
------------------------------------------------------------ |
------------------------------------------------------------ |
------------------------------------------------------------ |
-| length | 返回字符串的字符长度，而不是字符数组的长度。 |
支持一个参数，类型可以是字符串或文本。**string**：要计算长度的字符串。 | INT32
| length(string)
|
-| upper | 将字符串中的字母转换为大写。 |
支持一个参数，类型可以是字符串或文本。**string**：要计算长度的字符串。 | String
| upper(string)
|
-| lower | 将字符串中的字母转换为小写。 |
支持一个参数，类型可以是字符串或文本。**string**：要计算长度的字符串。 | String
| lower(string)
|
-| trim | 从源字符串中删除指定的开头和/或结尾字符。 |
支持三个参数**specification（可选）**：指定从哪边去掉字符，可以是：`BOTH`：两边都去掉（默认）。`LEADING`：只去掉开头的字符。`TRAILING`：只去掉结尾的字符。**trimcharacter（可选）**：要去掉的字符，如果没指定，默认去掉空格。**string**：要处理的字符串。
| String | trim([ [
specification ] [ trimcharacter ] FROM ] string) 示例：`trim('!' FROM '!foo!');`
—— `'foo'` |
-| strpos | 返回子字符串在字符串中第一次出现的起始位置。位置从 1 开始计数。如果未找到，返回
0。注意：起始位置是基于字符而不是字节数组确定的。 |
仅支持两个参数，类型可以是字符串或文本。**sourceStr**：要搜索的字符串。**subStr**：要找的子字符串。 | INT32
| strpos(sourceStr, subStr)
|
-| starts_with | 测试子字符串是否是字符串的前缀。 |
支持两个参数，类型可以是字符串或文本。**sourceStr**：要检查的字符串，类型可以是字符串或文本。**prefix**：前缀子字符串，类型可以是字符串或文本。
| Boolean |
starts_with(sourceStr, prefix) |
-| ends_with | 测试字符串是否以指定的后缀结束。 |
支持两个参数，类型可以是字符串或文本。**sourceStr**：要检查的字符串。**suffix**：后缀子字符串。 | Boolean
| ends_with(sourceStr, suffix)
|
-| concat | 返回字符串 `string1`、`string2`、...、`stringN` 的连接结果。功能与连接操作符 `||`
相同。 | 至少两个参数，所有参数类型必须是字符串或文本。 | String
| concat(str1, str2, ...) 或 str1 \|\| str2 ...
|
-| strcmp | 比较两个字符串的字母序。 |
支持两个参数，两个参数类型必须是字符串或文本。**string1**：第一个要比较的字符串。**string2**：第二个要比较的字符串。 |
返回一个整数值INT32如果 `str1 < str2`，返回 `-1`如果 `str1 = str2`，返回 `0`如果 `str1 > str2`，返回
`1`如果 `str1` 或 `str2` 为 `NULL`，返回 `NULL` | strcmp(str1, str2)
|
-| replace | 从字符串中删除所有 `search` 的实例。 |
支持两个参数，可以是字符串或文本类型。**string**：原始字符串，要从中删除内容的字符串。**search**：要删除的子字符串。 | String
| replace(string, string)
|
-| replace | 将字符串中所有 `search` 的实例替换为 `replace`。 |
支持三个参数，可以是字符串或文本类型。**string**：原始字符串，要从中替换内容的字符串。**search**：要替换掉的子字符串。**replace**：用来替换的新字符串。
| String |
replace(string, string, string) |
-| substring | 从指定位置提取字符到字符串末尾。需要注意的是，起始位置是基于字符而不是字节数组确定的。`start_index` 从 1
开始计数，长度从 `start_index` 位置计算。 |
支持两个参数**string**：要提取子字符串的源字符串，可以是字符串或文本类型。**start_index**：从哪个索引开始提取子字符串，索引从 1
开始计数。 | String：返回一个字符串，从 `start_index` 位置开始到字符串末尾的所有字符。**注意事项**：`start_index` 从
1 开始，即数组的第 0 个位置是 1参数为 null时，返回 `null`start_index 大于字符串长度时，结果报错。 |
substring(string from start_index)或 substring(string, start_index) |
-| substring |
从一个字符串中提取从指定位置开始、指定长度的子字符串注意：起始位置和长度是基于字符而不是字节数组确定的。`start_index` 从 1 开始计数，长度从
`start_index` 位置计算。 |
支持三个参数**string**：要提取子字符串的源字符串，可以是字符串或文本类型。**start_index**：从哪个索引开始提取子字符串，索引从 1
开始计数。**length**：要提取的子字符串的长度。 | String：返回一个字符串，从 `start_index` 位置开始，提取 `length`
个字符。**注意事项**：参数为 null时，返回 `null`如果 `start_index` 大于字符串的长度，结果报错。如果 `length` 小于
0，结果报错。极端情况，`start_index + length` 超过 `int.MAX` 并变成负数，将导致异常结果。 |
substring(string from start_index for length) 或 substring(string, start_in
[...]
+| 函数名 | 描述
| 输入
| 输出
| 用法 |
+| -----------
|---------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|
------------------------------------------------------------ |
------------------------------------------------------------ |
+| length | 返回字符串的字符长度，而不是字符数组的长度。
| 支持一个参数，类型可以是字符串或文本。**string**：要计算长度的字符串。
| INT32
| length(string)
|
+| upper | 将字符串中的字母转换为大写。
| 支持一个参数，类型可以是字符串或文本。**string**：要计算长度的字符串。
| String
| upper(string)
|
+| lower | 将字符串中的字母转换为小写。
| 支持一个参数，类型可以是字符串或文本。**string**：要计算长度的字符串。
| String
| lower(string)
|
+| trim | 从源字符串中删除指定的开头和/或结尾字符。
|
支持三个参数**specification（可选）**：指定从哪边去掉字符，可以是：`BOTH`：两边都去掉（默认）。`LEADING`：只去掉开头的字符。`TRAILING`：只去掉结尾的字符。**trimcharacter（可选）**：要去掉的字符，如果没指定，默认去掉空格。**string**：要处理的字符串。
| String | trim([ [
specification ] [ trimcharacter ] FROM ] string) 示例：`trim('!' FROM '!foo!');`
—— `'foo'` |
+| strpos | 返回子字符串在字符串中第一次出现的起始位置。位置从 1 开始计数。如果未找到，返回
0。注意：起始位置是基于字符而不是字节数组确定的。 |
仅支持两个参数，类型可以是字符串或文本。**sourceStr**：要搜索的字符串。**subStr**：要找的子字符串。
| INT32 |
strpos(sourceStr, subStr) |
+| starts_with | 测试子字符串是否是字符串的前缀。
|
支持两个参数，类型可以是字符串或文本。**sourceStr**：要检查的字符串，类型可以是字符串或文本。**prefix**：前缀子字符串，类型可以是字符串或文本。
|
Boolean |
starts_with(sourceStr, prefix) |
+| ends_with | 测试字符串是否以指定的后缀结束。
|
支持两个参数，类型可以是字符串或文本。**sourceStr**：要检查的字符串。**suffix**：后缀子字符串。
| Boolean |
ends_with(sourceStr, suffix) |
+| concat | 返回字符串 `string1`、`string2`、...、`stringN` 的连接结果。功能与连接操作符 `\|\|`
相同。 | 至少两个参数，所有参数类型必须是字符串或文本。 | String
| concat(str1, str2, ...) 或
str1 \|\| str2 ... |
+| strcmp | 比较两个字符串的字母序。
|
支持两个参数，两个参数类型必须是字符串或文本。**string1**：第一个要比较的字符串。**string2**：第二个要比较的字符串。
| 返回一个整数值INT32如果 `str1 < str2`，返回 `-1`如果 `str1 = str2`，返回 `0`如果 `str1 >
str2`，返回 `1`如果 `str1` 或 `str2` 为 `NULL`，返回 `NULL` | strcmp(str1, str2)
|
+| replace | 从字符串中删除所有 `search` 的实例。
|
支持两个参数，可以是字符串或文本类型。**string**：原始字符串，要从中删除内容的字符串。**search**：要删除的子字符串。
| String |
replace(string, string) |
+| replace | 将字符串中所有 `search` 的实例替换为 `replace`。
|
支持三个参数，可以是字符串或文本类型。**string**：原始字符串，要从中替换内容的字符串。**search**：要替换掉的子字符串。**replace**：用来替换的新字符串。
| String
| replace(string, string,
string) |
+| substring | 从指定位置提取字符到字符串末尾。需要注意的是，起始位置是基于字符而不是字节数组确定的。`start_index` 从 1
开始计数，长度从 `start_index` 位置计算。 |
支持两个参数**string**：要提取子字符串的源字符串，可以是字符串或文本类型。**start_index**：从哪个索引开始提取子字符串，索引从 1
开始计数。
| String：返回一个字符串，从 `start_index` 位置开始到字符串末尾的所有字符。**注意事项**：`start_index` 从 1
开始，即数组的第 0 个位置是 1参数为 null时，返回 `null`start_index 大于字符串长度时，结果报错。 |
substring(string from start_index)或 substring(string, start_index) |
+| substring |
从一个字符串中提取从指定位置开始、指定长度的子字符串注意：起始位置和长度是基于字符而不是字节数组确定的。`start_index` 从 1 开始计数，长度从
`start_index` 位置计算。 |
支持三个参数**string**：要提取子字符串的源字符串，可以是字符串或文本类型。**start_index**：从哪个索引开始提取子字符串，索引从 1
开始计数。**length**：要提取的子字符串的长度。
| String：返回一个字符串，从 `start_index` 位置开始，提取 `length` 个字符。**注意事项**：参数为 null时，返回
`null`如果 `start_index` 大于字符串的长度，结果报错。如果 `length` 小于 0，结果报错。极端情况，`start_index +
length` 超过 `int.MAX` 并变成负数，将导致异常结果。 | substring(string from [...]
## 9. 模式匹配函数
diff --git a/src/zh/UserGuide/latest-Table/SQL-Manual/Basis-Function.md
b/src/zh/UserGuide/latest-Table/SQL-Manual/Basis-Function.md
index c2d312da..b0ab5ca9 100644
--- a/src/zh/UserGuide/latest-Table/SQL-Manual/Basis-Function.md
+++ b/src/zh/UserGuide/latest-Table/SQL-Manual/Basis-Function.md
@@ -769,21 +769,21 @@ SELECT *
### 8.2 字符串函数
-| 函数名 | 描述 | 输入
| 输出
| 用法
|
-| ----------- | ------------------------------------------------------------ |
------------------------------------------------------------ |
------------------------------------------------------------ |
------------------------------------------------------------ |
-| length | 返回字符串的字符长度，而不是字符数组的长度。 |
支持一个参数，类型可以是字符串或文本。**string**：要计算长度的字符串。 | INT32
| length(string)
|
-| upper | 将字符串中的字母转换为大写。 |
支持一个参数，类型可以是字符串或文本。**string**：要计算长度的字符串。 | String
| upper(string)
|
-| lower | 将字符串中的字母转换为小写。 |
支持一个参数，类型可以是字符串或文本。**string**：要计算长度的字符串。 | String
| lower(string)
|
-| trim | 从源字符串中删除指定的开头和/或结尾字符。 |
支持三个参数**specification（可选）**：指定从哪边去掉字符，可以是：`BOTH`：两边都去掉（默认）。`LEADING`：只去掉开头的字符。`TRAILING`：只去掉结尾的字符。**trimcharacter（可选）**：要去掉的字符，如果没指定，默认去掉空格。**string**：要处理的字符串。
| String | trim([ [
specification ] [ trimcharacter ] FROM ] string) 示例：`trim('!' FROM '!foo!');`
—— `'foo'` |
-| strpos | 返回子字符串在字符串中第一次出现的起始位置。位置从 1 开始计数。如果未找到，返回
0。注意：起始位置是基于字符而不是字节数组确定的。 |
仅支持两个参数，类型可以是字符串或文本。**sourceStr**：要搜索的字符串。**subStr**：要找的子字符串。 | INT32
| strpos(sourceStr, subStr)
|
-| starts_with | 测试子字符串是否是字符串的前缀。 |
支持两个参数，类型可以是字符串或文本。**sourceStr**：要检查的字符串，类型可以是字符串或文本。**prefix**：前缀子字符串，类型可以是字符串或文本。
| Boolean |
starts_with(sourceStr, prefix) |
-| ends_with | 测试字符串是否以指定的后缀结束。 |
支持两个参数，类型可以是字符串或文本。**sourceStr**：要检查的字符串。**suffix**：后缀子字符串。 | Boolean
| ends_with(sourceStr, suffix)
|
-| concat | 返回字符串 `string1`、`string2`、...、`stringN` 的连接结果。功能与连接操作符 `||`
相同。 | 至少两个参数，所有参数类型必须是字符串或文本。 | String
| concat(str1, str2, ...) 或 str1 \|\| str2 ...
|
-| strcmp | 比较两个字符串的字母序。 |
支持两个参数，两个参数类型必须是字符串或文本。**string1**：第一个要比较的字符串。**string2**：第二个要比较的字符串。 |
返回一个整数值INT32如果 `str1 < str2`，返回 `-1`如果 `str1 = str2`，返回 `0`如果 `str1 > str2`，返回
`1`如果 `str1` 或 `str2` 为 `NULL`，返回 `NULL` | strcmp(str1, str2)
|
-| replace | 从字符串中删除所有 `search` 的实例。 |
支持两个参数，可以是字符串或文本类型。**string**：原始字符串，要从中删除内容的字符串。**search**：要删除的子字符串。 | String
| replace(string, string)
|
-| replace | 将字符串中所有 `search` 的实例替换为 `replace`。 |
支持三个参数，可以是字符串或文本类型。**string**：原始字符串，要从中替换内容的字符串。**search**：要替换掉的子字符串。**replace**：用来替换的新字符串。
| String |
replace(string, string, string) |
-| substring | 从指定位置提取字符到字符串末尾。需要注意的是，起始位置是基于字符而不是字节数组确定的。`start_index` 从 1
开始计数，长度从 `start_index` 位置计算。 |
支持两个参数**string**：要提取子字符串的源字符串，可以是字符串或文本类型。**start_index**：从哪个索引开始提取子字符串，索引从 1
开始计数。 | String：返回一个字符串，从 `start_index` 位置开始到字符串末尾的所有字符。**注意事项**：`start_index` 从
1 开始，即数组的第 0 个位置是 1参数为 null时，返回 `null`start_index 大于字符串长度时，结果报错。 |
substring(string from start_index)或 substring(string, start_index) |
-| substring |
从一个字符串中提取从指定位置开始、指定长度的子字符串注意：起始位置和长度是基于字符而不是字节数组确定的。`start_index` 从 1 开始计数，长度从
`start_index` 位置计算。 |
支持三个参数**string**：要提取子字符串的源字符串，可以是字符串或文本类型。**start_index**：从哪个索引开始提取子字符串，索引从 1
开始计数。**length**：要提取的子字符串的长度。 | String：返回一个字符串，从 `start_index` 位置开始，提取 `length`
个字符。**注意事项**：参数为 null时，返回 `null`如果 `start_index` 大于字符串的长度，结果报错。如果 `length` 小于
0，结果报错。极端情况，`start_index + length` 超过 `int.MAX` 并变成负数，将导致异常结果。 |
substring(string from start_index for length) 或 substring(string, start_in
[...]
+| 函数名 | 描述
| 输入
| 输出
| 用法 |
+| -----------
|---------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|
------------------------------------------------------------ |
------------------------------------------------------------ |
+| length | 返回字符串的字符长度，而不是字符数组的长度。
| 支持一个参数，类型可以是字符串或文本。**string**：要计算长度的字符串。
| INT32
| length(string)
|
+| upper | 将字符串中的字母转换为大写。
| 支持一个参数，类型可以是字符串或文本。**string**：要计算长度的字符串。
| String
| upper(string)
|
+| lower | 将字符串中的字母转换为小写。
| 支持一个参数，类型可以是字符串或文本。**string**：要计算长度的字符串。
| String
| lower(string)
|
+| trim | 从源字符串中删除指定的开头和/或结尾字符。
|
支持三个参数**specification（可选）**：指定从哪边去掉字符，可以是：`BOTH`：两边都去掉（默认）。`LEADING`：只去掉开头的字符。`TRAILING`：只去掉结尾的字符。**trimcharacter（可选）**：要去掉的字符，如果没指定，默认去掉空格。**string**：要处理的字符串。
| String | trim([ [
specification ] [ trimcharacter ] FROM ] string) 示例：`trim('!' FROM '!foo!');`
—— `'foo'` |
+| strpos | 返回子字符串在字符串中第一次出现的起始位置。位置从 1 开始计数。如果未找到，返回
0。注意：起始位置是基于字符而不是字节数组确定的。 |
仅支持两个参数，类型可以是字符串或文本。**sourceStr**：要搜索的字符串。**subStr**：要找的子字符串。
| INT32 |
strpos(sourceStr, subStr) |
+| starts_with | 测试子字符串是否是字符串的前缀。
|
支持两个参数，类型可以是字符串或文本。**sourceStr**：要检查的字符串，类型可以是字符串或文本。**prefix**：前缀子字符串，类型可以是字符串或文本。
|
Boolean |
starts_with(sourceStr, prefix) |
+| ends_with | 测试字符串是否以指定的后缀结束。
|
支持两个参数，类型可以是字符串或文本。**sourceStr**：要检查的字符串。**suffix**：后缀子字符串。
| Boolean |
ends_with(sourceStr, suffix) |
+| concat | 返回字符串 `string1`、`string2`、...、`stringN` 的连接结果。功能与连接操作符 `\|\|`
相同。 | 至少两个参数，所有参数类型必须是字符串或文本。 | String
| concat(str1, str2, ...) 或
str1 \|\| str2 ... |
+| strcmp | 比较两个字符串的字母序。
|
支持两个参数，两个参数类型必须是字符串或文本。**string1**：第一个要比较的字符串。**string2**：第二个要比较的字符串。
| 返回一个整数值INT32如果 `str1 < str2`，返回 `-1`如果 `str1 = str2`，返回 `0`如果 `str1 >
str2`，返回 `1`如果 `str1` 或 `str2` 为 `NULL`，返回 `NULL` | strcmp(str1, str2)
|
+| replace | 从字符串中删除所有 `search` 的实例。
|
支持两个参数，可以是字符串或文本类型。**string**：原始字符串，要从中删除内容的字符串。**search**：要删除的子字符串。
| String |
replace(string, string) |
+| replace | 将字符串中所有 `search` 的实例替换为 `replace`。
|
支持三个参数，可以是字符串或文本类型。**string**：原始字符串，要从中替换内容的字符串。**search**：要替换掉的子字符串。**replace**：用来替换的新字符串。
| String
| replace(string, string,
string) |
+| substring | 从指定位置提取字符到字符串末尾。需要注意的是，起始位置是基于字符而不是字节数组确定的。`start_index` 从 1
开始计数，长度从 `start_index` 位置计算。 |
支持两个参数**string**：要提取子字符串的源字符串，可以是字符串或文本类型。**start_index**：从哪个索引开始提取子字符串，索引从 1
开始计数。
| String：返回一个字符串，从 `start_index` 位置开始到字符串末尾的所有字符。**注意事项**：`start_index` 从 1
开始，即数组的第 0 个位置是 1参数为 null时，返回 `null`start_index 大于字符串长度时，结果报错。 |
substring(string from start_index)或 substring(string, start_index) |
+| substring |
从一个字符串中提取从指定位置开始、指定长度的子字符串注意：起始位置和长度是基于字符而不是字节数组确定的。`start_index` 从 1 开始计数，长度从
`start_index` 位置计算。 |
支持三个参数**string**：要提取子字符串的源字符串，可以是字符串或文本类型。**start_index**：从哪个索引开始提取子字符串，索引从 1
开始计数。**length**：要提取的子字符串的长度。
| String：返回一个字符串，从 `start_index` 位置开始，提取 `length` 个字符。**注意事项**：参数为 null时，返回
`null`如果 `start_index` 大于字符串的长度，结果报错。如果 `length` 小于 0，结果报错。极端情况，`start_index +
length` 超过 `int.MAX` 并变成负数，将导致异常结果。 | substring(string from [...]
## 9. 模式匹配函数
