TRIM_IN

Описание

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

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

Синтаксис

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

Параметры

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

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

Возвращает обработанную строку типа VARCHAR.

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

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

Примеры

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

SELECT trim_in('   ab d   ') str;

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

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

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

+------+
| str  |
+------+
| cc   |
+------+

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

SELECT trim_in('ababccaab', 'ab'), trim('ababccaab', 'ab');

+----------------------------+-------------------------+
| trim_in('ababccaab', 'ab') | trim('ababccaab', 'ab') |
+----------------------------+-------------------------+
| cc                         | cca                     |
+----------------------------+-------------------------+

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

SELECT trim_in('abcHelloabc', 'cba');

+--------------------------------+
| trim_in('abcHelloabc', 'cba')  |
+--------------------------------+
| Hello                          |
+--------------------------------+

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

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

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

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

SELECT trim_in(NULL, 'abc');

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

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

SELECT trim_in('', 'abc'), trim_in('abc', '');

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

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

TRIM_IN, TRIM