UCASE/UPPER

Описание

Функция UCASE (псевдоним UPPER) преобразует все строчные буквы в строке в прописные. Эта функция поддерживает преобразование символов Unicode и корректно обрабатывает правила изменения регистра для различных языков.

Синтаксис

UCASE(<str>)
UPPER(<str>)

Параметры

Параметр	Описание
<str>	Строка для преобразования в верхний регистр. Тип: VARCHAR

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

Возвращает значение типа VARCHAR, представляющее строку, преобразованную в верхний регистр.

Правила преобразования:

• Все строчные буквы в строке преобразуются в соответствующие прописные буквы
• Символы, не являющиеся буквами (цифры, специальные символы, пробелы и т. д.), остаются без изменений
• Буквы, уже находящиеся в верхнем регистре, остаются без изменений

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

• Возвращает NULL, если параметр равен NULL
• Возвращает пустую строку, если входная строка пуста
• Возвращает исходную строку, если в ней нет строчных букв

Примеры

1. Простое преобразование английских букв

SELECT UCASE('aBc123'), UPPER('aBc123');

+-----------------+-----------------+
| UCASE('aBc123') | UPPER('aBc123') |
+-----------------+-----------------+
| ABC123          | ABC123          |
+-----------------+-----------------+

2. Обработка строки с разными символами

SELECT UCASE('Hello World!'), UPPER('test@123');

+----------------------+------------------+
| UCASE('Hello World!') | UPPER('test@123') |
+----------------------+------------------+
| HELLO WORLD!         | TEST@123         |
+----------------------+------------------+

3. Обработка значений NULL

SELECT UCASE(NULL), UPPER(NULL);

+-------------+-------------+
| UCASE(NULL) | UPPER(NULL) |
+-------------+-------------+
| NULL        | NULL        |
+-------------+-------------+

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

SELECT UCASE(''), UPPER('');

+-----------+-----------+
| UCASE('') | UPPER('') |
+-----------+-----------+
|           |           |
+-----------+-----------+

5. Строка, уже записанная в верхнем регистре

SELECT UCASE('ALREADY UPPERCASE'), UPPER('ABC123');

+---------------------------+----------------+
| UCASE('ALREADY UPPERCASE') | UPPER('ABC123') |
+---------------------------+----------------+
| ALREADY UPPERCASE         | ABC123         |
+---------------------------+----------------+

6. Цифры и символы

SELECT UCASE('123!@#$%'), UPPER('price: $99.99');

+-------------------+----------------------+
| UCASE('123!@#$%') | UPPER('price: $99.99') |
+-------------------+----------------------+
| 123!@#$%          | PRICE: $99.99        |
+-------------------+----------------------+

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

SELECT UCASE('ṭṛì test'), UPPER('ḍḍumai hello');

+--------------------+-----------------------+
| UCASE('ṭṛì test')  | UPPER('ḍḍumai hello') |
+--------------------+-----------------------+
| ṬṚÌ TEST           | ḌḌUMAI HELLO          |
+--------------------+-----------------------+

8. Кириллические буквы

SELECT UCASE('Кириллица'), UPPER('Бәйтерек');

+---------------------+-------------------+
| UCASE('Кириллица')  | UPPER('Бәйтерек') |
+---------------------+-------------------+
| КИРИЛЛИЦА           | БӘЙТЕРЕК          |
+---------------------+-------------------+

Ключевые слова

UCASE, UPPER