REGEXP_REPLACE

📖 Описание

Функция Oracle/PLSQL REGEXP_REPLACE расширяет REPLACE и заменяет совпадения регулярного выражения другой строкой.


🧩 Синтаксис Oracle 19c

REGEXP_REPLACE(source_string, pattern
  [, replacement_string [, position [, occurrence [, match_param]]]])

⚙️ Параметры и аргументы

source_string — исходная строка; replacement_string — замена, при NULL или пропуске совпадения удаляются. position — положительная начальная позиция, по умолчанию 1.

occurrence по умолчанию равно 0: заменяются все совпадения. Положительное число выбирает только указанное вхождение. В строке замены доступны обратные ссылки \1–\9; для литеральной обратной косой черты используют две косые черты.

Шаблон pattern

Регулярное выражение ограничено 512 байтами. Основные операторы:

Оператор Назначение
^ Начало строки; с m — начало каждой строки текста
$ Конец строки; с m — конец каждой строки текста
* Ноль или более повторений предыдущего элемента
+ Одно или более повторений
? Ноль или одно повторение
. Любой символ; перевод строки включается только с параметром n
a|b Альтернатива: a или b
[abc] Один символ из набора
[^abc] Один символ вне набора
(...) Группа (подвыражение)
{m}, {m,}, {m,n} Ровно m, не менее m, от m до n повторений
\1 … \9 Обратная ссылка на ранее захваченную группу
[[.ch.]] Элемент сортировки, определённый локалью
[[:alpha:]] Класс символов; здесь буквы
[[=a=]] Класс эквивалентности, зависящий от локали
\d / \D Цифра / не цифра
\w / \W Буква, цифра или подчёркивание / другой символ
\s / \S Пробельный / непробельный символ
\A Начало всего текста независимо от m
\Z Конец всего текста, также позиция перед завершающим переводом строки
*?, +?, ?? Нежадные варианты: минимальное число повторений, позволяющее остальному шаблону совпасть
{m}?, {m,}?, {m,n}? Нежадные варианты ограниченного повторения

Параметр match_param

Значение Поведение
c Учитывать регистр и диакритические знаки
i Не учитывать регистр
n Разрешить точке совпадать с переводом строки
m Считать ^ и $ границами каждой строки текста
x Игнорировать пробельные символы в шаблоне

При конфликте c и i действует последний символ. Без явного c или i чувствительность определяется правилами сравнения строк (collation), поэтому в примерах она указана явно.


💻 Примеры

Первое слово

SELECT REGEXP_REPLACE('Old studio opens today', '^\S+', 'New', 1, 0, 'c') FROM dual;
-- Результат: New studio opens today

Якорь ^ ограничивает поиск началом текста, а \S+ выбирает первое слово.

Цифры и пары цифр

SELECT REGEXP_REPLACE('Boxes: 3, 7, 24', '\d', '@', 1, 0, 'c') FROM dual;
-- Результат: Boxes: @, @, @@

SELECT REGEXP_REPLACE('Boxes: 3, 7, 24', '\d{2}', '@', 1, 0, 'c') FROM dual;
-- Результат: Boxes: 3, 7, @
WITH studio_rooms (room_id, label) AS (
  SELECT 1, 'Room 24, shelf 7' FROM dual UNION ALL
  SELECT 2, 'Room 8, shelf 31' FROM dual
)
SELECT room_id,
       REGEXP_REPLACE(label, '\d{2}', 'XX', 1, 0, 'c') AS masked_label
FROM studio_rooms
ORDER BY room_id;
ROOM_ID MASKED_LABEL
1 Room XX, shelf 7
2 Room 8, shelf XX

\d заменяет отдельные цифры; \d{2} — пары соседних цифр, в том числе внутри более длинных чисел.

Альтернативы и регистр

SELECT REGEXP_REPLACE('Olive', 'a|e|i|o|u', 'R', 1, 0, 'c') FROM dual;
-- Результат: OlRvR

SELECT REGEXP_REPLACE('Olive', 'a|e|i|o|u', 'R', 1, 0, 'i') FROM dual;
-- Результат: RlRvR
WITH studio_names (studio_id, title) AS (
  SELECT 1, 'Olive' FROM dual UNION ALL
  SELECT 2, 'Maple' FROM dual UNION ALL
  SELECT 3, 'Cedar' FROM dual
)
SELECT studio_id, title,
       REGEXP_REPLACE(title, 'a|e|i|o|u', 'R', 1, 0, 'i') AS new_title
FROM studio_names
ORDER BY studio_id;
STUDIO_ID TITLE NEW_TITLE
1 Olive RlRvR
2 Maple MRplR
3 Cedar CRdRr

Первое, второе и третье вхождения

SELECT REGEXP_REPLACE('Olive', 'a|e|i|o|u', 'Z', 1, 1, 'i') FROM dual;
-- Результат: Zlive

SELECT REGEXP_REPLACE('Olive', 'a|e|i|o|u', 'Z', 1, 2, 'i') FROM dual;
-- Результат: OlZve

SELECT REGEXP_REPLACE('Olive', 'a|e|i|o|u', 'Z', 1, 3, 'i') FROM dual;
-- Результат: OlivZ

При occurrence = 1, 2 и 3 заменяются соответственно O, i и e. Остальные гласные сохраняются.

См. документацию Oracle: REGEXP_REPLACE.

См. документацию Oracle: операторы регулярных выражений.

Подробности якорей и классов: Oracle Database Development Guide.