RTRIM_IN

Описание

Функция RTRIM_IN удаляет заданные символы с правого края строки. Если набор символов не указан, по умолчанию удаляются пробелы в конце строки. Если набор символов указан, с правого края удаляются все символы, входящие в этот набор (независимо от их порядка в наборе).

Ключевая особенность RTRIM_IN заключается в том, что она удаляет любое сочетание символов из заданного набора, тогда как функция RTRIM удаляет символы на основе точного совпадения строк.

Синтаксис

RTRIM_IN(<str>[, <rhs>])

Параметры

Параметр	Описание
<str>	Обрабатываемая строка. Тип: VARCHAR
<rhs>	Необязательный параметр: набор символов для удаления. Тип: VARCHAR

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

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

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

• Если str имеет значение NULL, возвращает NULL
• Если rhs не указан, удаляет все пробелы в конце строки
• Если rhs указан, удаляет с правого края все символы, входящие в rhs, до первого символа, не входящего в rhs

Примеры

1. Удаление пробелов в конце строки

SELECT rtrim_in('ab d   ') str;

+------+
| str  |
+------+
| ab d |
+------+

2. Удаление символов из заданного набора

SELECT rtrim_in('ababccaab', 'ab') str;

+---------+
| str     |
+---------+
| ababcc  |
+---------+

3. Сравнение с функцией RTRIM

SELECT rtrim_in('ababccaab', 'ab'), rtrim('ababccaab', 'ab');

+-----------------------------+--------------------------+
| rtrim_in('ababccaab', 'ab') | rtrim('ababccaab', 'ab') |
+-----------------------------+--------------------------+
| ababcc                      | ababcca                  |
+-----------------------------+--------------------------+

4. Порядок символов в наборе не имеет значения

SELECT rtrim_in('Helloabc', 'cba');

+-----------------------------+
| rtrim_in('Helloabc', 'cba') |
+-----------------------------+
| Hello                       |
+-----------------------------+

5. Поддержка символов UTF-8

SELECT rtrim_in('ṭṛì ḍḍumai+++', '+');

+------------------------------------+
| rtrim_in('ṭṛì ḍḍumai+++', '+')    |
+------------------------------------+
| ṭṛì ḍḍumai                         |
+------------------------------------+

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

SELECT rtrim_in(NULL, 'abc');

+------------------------+
| rtrim_in(NULL, 'abc')  |
+------------------------+
| NULL                   |
+------------------------+

7. Обработка пустых строк

SELECT rtrim_in('', 'abc'), rtrim_in('abc', '');

+---------------------+---------------------+
| rtrim_in('', 'abc') | rtrim_in('abc', '') |
+---------------------+---------------------+
|                     | abc                 |
+---------------------+---------------------+

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

RTRIM_IN, RTRIM