MariaDB CHARACTER_LENGTH() 函数使用指南

在 MariaDB 中，CHARACTER_LENGTH() 是一个内置的字符串函数，它返回给定字符串参数的字符数量。

CHARACTER_LENGTH() 函数是 CHAR_LENGTH() 函数的别名。

MariaDB CHARACTER_LENGTH() 语法

这里是 MariaDB CHARACTER_LENGTH() 函数的语法：

CHARACTER_LENGTH(str)

参数说明

str

必需的。 需要计算长度的字符串。

如果缺少参数， MariaDB 将报告错误：ERROR 1582 (42000): Incorrect parameter count in the call to native function ‘CHARACTER_LENGTH’。

返回值

MariaDB CHARACTER_LENGTH() 函数返回给定字符串参数的字符数量。如果参数 str 为 NULL，它将返回 NULL。

CHARACTER_LENGTH() 函数返回的字符的个数，而不是字节的个数。如果要返回字符串的字节长度，请使用 LENGTH() 函数。如果要返回字符串中位的数量，请使用 BIT_LENGTH() 函数。

如果您使用 NULL 参数，CHARACTER_LENGTH() 函数将返回 NULL。

MariaDB CHARACTER_LENGTH() 示例

下面的语句使用 MariaDB CHARACTER_LENGTH() 函数返回字符串 Hello 的长度：

SELECT CHARACTER_LENGTH('Hello');

输出：

+---------------------------+
| CHARACTER_LENGTH('Hello') |
+---------------------------+
|                         5 |
+---------------------------+

对于多字节字符，CHARACTER_LENGTH() 仍将其视为一个字符，无论它包含多少字节。

下面的语句使用 MariaDB CHARACTER_LENGTH() 函数返回中文字符串 你好 的长度：

SELECT CHARACTER_LENGTH('你好');

输出：

+----------------------------+
| CHARACTER_LENGTH('你好')   |
+----------------------------+
|                          2 |
+----------------------------+

在本示例中， CHARACTER_LENGTH('你好') 返回了 2。因为 你好 这个字符串中只有 2 个字。

结论

MariaDB CHARACTER_LENGTH() 函数返回给定字符串参数的字符数量。 CHARACTER_LENGTH() 函数返回的结果与字符所占用的字节数无关。