ASCII

Описание

Возвращает значение ASCII-кода первого символа строки. Функция обрабатывает только первый символ строки, поэтому для строк из нескольких символов возвращает только ASCII-код первого символа.

Синтаксис

ASCII(<str>)

Параметры

Параметр	Описание
<str>	Строка, для первого символа которой нужно получить ASCII-код. Тип: VARCHAR

Возвращаемое значение

Возвращает значение типа INT, представляющее ASCII-код первого символа строки.

Особые случаи:

• Если параметр равен NULL, возвращает NULL
• Если строка пустая, возвращает 0
• Если первый символ не является символом ASCII (значение кода больше 127), возвращает соответствующее значение байта
• Для многобайтовых символов UTF-8 возвращает значение первого байта

Примеры

1. Базовые примеры с цифрами

SELECT ASCII('1'), ASCII('234');

+------------+--------------+
| ASCII('1') | ASCII('234') |
+------------+--------------+
|         49 |           50 |
+------------+--------------+

2. Буквы

SELECT ASCII('A'), ASCII('a'), ASCII('Z');

+------------+------------+------------+
| ASCII('A') | ASCII('a') | ASCII('Z') |
+------------+------------+------------+
|         65 |         97 |         90 |
+------------+------------+------------+

3. Обработка пустой строки

SELECT ASCII('');

+-----------+
| ASCII('') |
+-----------+
|         0 |
+-----------+

4. Обработка значения NULL

SELECT ASCII(NULL);

+-------------+
| ASCII(NULL) |
+-------------+
|        NULL |
+-------------+

5. Специальные символы

SELECT ASCII(' '), ASCII('!'), ASCII('@');

+------------+------------+------------+
| ASCII(' ') | ASCII('!') | ASCII('@') |
+------------+------------+------------+
|         32 |         33 |         64 |
+------------+------------+------------+

6. Управляющие символы

SELECT ASCII('\t'), ASCII('\n'), ASCII('\r');

+-------------+-------------+-------------+
| ASCII('\t') | ASCII('\n') | ASCII('\r') |
+-------------+-------------+-------------+
|           9 |          10 |          13 |
+-------------+-------------+-------------+

7. Строки из нескольких символов (возвращается только первый символ)

SELECT ASCII('Hello'), ASCII('World123');

+----------------+------------------+
| ASCII('Hello') | ASCII('World123') |
+----------------+------------------+
|             72 |               87 |
+----------------+------------------+

8. Многобайтовые символы UTF-8

SELECT ASCII('ṭṛì'), ASCII('ḍḍumai');

+---------------+------------------+
| ASCII('ṭṛì')  | ASCII('ḍḍumai') |
+---------------+------------------+
|           225 |              225 |
+---------------+------------------+

9. Сочетание цифр и символов

SELECT ASCII('9abc'), ASCII('0xyz');

+---------------+---------------+
| ASCII('9abc') | ASCII('0xyz') |
+---------------+---------------+
|            57 |            48 |
+---------------+---------------+