类别：: 字符串和二进制函数（通用）

CONCAT_WS¶

连接两个或多个字符串，或连接两个或多个二进制值。如果任何值为 null，则结果也为 null。

CONCAT_WS 运算符需要至少两个实参，并使用第一个实参分隔所有后续实参。

另请参阅：: CONCAT

语法¶

CONCAT_WS( <separator> , <expression1> [ , <expressionN> ... ] )

Copy

实参¶

separator: 分隔符必须满足与 expressionN 相同的要求。
expressionN: 输入表达式必须全部为字符串，或全部为二进制值。

返回¶

该函数返回包含第 2 个到第 N 个实参（由第一个实参分隔）的 VARCHAR 或 BINARY。

返回值的数据类型与输入值的数据类型相同。

使用说明¶

元数据函数（如 GET_DDL）仅接受常量作为输入。连接的输入会生成错误。
CONCAT_WS 在实参之间放置分隔符，而不是在最后一个实参之后放置分隔符。如果在分隔符后仅使用一个实参调用 CONCAT_WS，则不追加分隔符。

排序规则详细信息¶

The collation specifications of all input arguments must be compatible.
The collation of the result of the function is the highest-precedence collation of the inputs.

示例¶

用分隔符连接三个字符串：

SELECT CONCAT_WS(',', 'one', 'two', 'three');
+---------------------------------------+
| CONCAT_WS(',', 'ONE', 'TWO', 'THREE') |
|---------------------------------------|
| one,two,three                         |
+---------------------------------------+

Copy

当只有一个字符串要连接时，CONCAT_WS 不追加分隔符：

SELECT CONCAT_WS(',', 'one');
+-----------------------+
| CONCAT_WS(',', 'ONE') |
|-----------------------|
| one                   |
+-----------------------+

Copy