OVERLAY

Описание

Функция OVERLAY используется для замены подстроки заданной длины в указанной позиции строки. Начиная с указанной позиции, она заменяет заданное количество символов новой строкой. Эта функция корректно работает с многобайтовыми символами.

Поведение этой функции соответствует поведению функции INSERT в MySQL.

Псевдоним

• INSERT

Синтаксис

OVERLAY(<str>, <pos>, <len>, <newstr>)

Параметры

Параметр	Описание
<str>	Исходная строка, которую нужно изменить. Тип: VARCHAR
<pos>	Начальная позиция замены (нумерация с 1). Тип: INT
<len>	Количество символов для замены. Тип: INT
<newstr>	Новая строка для замены. Тип: VARCHAR

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

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

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

• Если любой из параметров равен NULL, возвращает NULL
• Если <pos> меньше 1 или превышает длину строки, замена не выполняется и возвращается исходная строка
• Если <len> меньше 0 или превышает оставшуюся длину, замена выполняется от <pos> до конца строки

Примеры

1. Базовое использование: замена средней части строки

SELECT overlay('Quadratic', 3, 4, 'What');

+------------------------------------+
| overlay('Quadratic', 3, 4, 'What') |
+------------------------------------+
| QuWhattic                          |
+------------------------------------+

2. Отрицательная длина: замена до конца строки

SELECT overlay('Quadratic', 2, -1, 'Hi');

+-----------------------------------+
| overlay('Quadratic', 2, -1, 'Hi') |
+-----------------------------------+
| QHi                               |
+-----------------------------------+

3. Позиция за пределами строки: замена не выполняется

SELECT overlay('Hello', 10, 2, 'X');

+-------------------------------+
| overlay('Hello', 10, 2, 'X')  |
+-------------------------------+
| Hello                         |
+-------------------------------+

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

SELECT overlay('Hello', NULL, 2, 'X');

+--------------------------------+
| overlay('Hello', NULL, 2, 'X') |
+--------------------------------+
| NULL                           |
+--------------------------------+

SELECT INSERT('🎉🎊🎈', 2, 1, '🎁');

+--------------------------------------+
| INSERT('🎉🎊🎈', 2, 1, '🎁')                 |
+--------------------------------------+
| 🎉🎁🎈                                     |
+--------------------------------------+