类别：

:doc:`/sql-reference/functions-string`（匹配/比较）

LEFT

返回其输入中最左侧的子字符串。LEFT(STR,N) 等同于 SUBSTR(STR,1,N)。

另请参阅:

RIGHT、SUBSTR、SUBSTRING

语法

LEFT( <string_expr> , <length_expr> )
Copy

实参

string_expr

这必须是 VARCHAR 或 BINARY 值。

length_expr

长度应该是一个计算结果为整数的表达式。它应该指定：

  • 如果输入为 VARCHAR，返回的 UTF-8 字符数。

  • 如果输入为 BINARY，返回的字节数。

长度应大于或等于零。如果长度为负数，该函数会返回一个空字符串。

返回

返回值的数据类型与输入值（BINARY 或 VARCHAR）的数据类型相同。

排序规则详细信息

排序规则适用于 VARCHAR 输入。如果第一个参数的输入数据类型为 BINARY，则排序规则不适用。

尽管在语法上可以接受排序规则，但排序规则对处理没有影响。例如，某些语言的字母包含两个字符或三个字符（如匈牙利语中的“dzs”，捷克语中的“ch”），这些字母作为长度实参时仍会算作两个或三个字符（而不是一个字符）。

但是，返回值将保留第一个实参的排序规则规范。如果返回值作为嵌套函数调用的一部分传递给另一个函数，这可能很有用。

示例

SELECT LEFT('ABCDEF', 3);

-------------------+
 LEFT('ABCDEF', 3) |
-------------------+
 ABC               |
-------------------+
Copy
语言: 中文