CHAR_LENGTH

Синтаксис

CHAR_LENGTH(str)
CHARACTER_LENGTH(str)

Описание

Возвращает длину заданного строкового аргумента, измеряемую в символах. Многобайтовый символ считается одним символом. Это означает, что для строки, содержащей пять двухбайтовых символов, LENGTH() (или OCTET_LENGTH() в режиме Oracle) возвращает 10, тогда как CHAR_LENGTH() возвращает 5. Если аргумент NULL, он возвращает NULL.

Если аргумент не является строковым значением, он преобразуется в строку.

Это синоним функции CHARACTER_LENGTH().

Примеры

SELECT CHAR_LENGTH('MariaDB');
+------------------------+
| CHAR_LENGTH('MariaDB') |
+------------------------+
|                      7 |
+------------------------+

Когда режим Oracle из MariaDB 10.3 не установлен:

SELECT CHAR_LENGTH('π'), LENGTH('π'), LENGTHB('π'), OCTET_LENGTH('π');
+-------------------+--------------+---------------+--------------------+
| CHAR_LENGTH('π')  | LENGTH('π')  | LENGTHB('π')  | OCTET_LENGTH('π')  |
+-------------------+--------------+---------------+--------------------+
|                 1 |            2 |             2 |                  2 |
+-------------------+--------------+---------------+--------------------+

В режиме Oracle из MariaDB 10.3:

SELECT CHAR_LENGTH('π'), LENGTH('π'), LENGTHB('π'), OCTET_LENGTH('π');
+-------------------+--------------+---------------+--------------------+
| CHAR_LENGTH('π')  | LENGTH('π')  | LENGTHB('π')  | OCTET_LENGTH('π')  |
+-------------------+--------------+---------------+--------------------+
|                 1 |            1 |             2 |                  2 |
+-------------------+--------------+---------------+--------------------+

См. также

• LENGTH()
• LENGTHB()
• OCTET_LENGTH()
• Режим Oracle от MariaDB 10.3