Глобальный контекст.СтрЗаменитьПоРегулярномуВыражению (Global context.StrReplaceByRegularExpression)

Глобальный контекст (Global context)

СтрЗаменитьПоРегулярномуВыражению (StrReplaceByRegularExpression)

Доступен, начиная с версии 8.3.23.

Синтаксис:

СтрЗаменитьПоРегулярномуВыражению(<Строка>, <РегулярноеВыражение>, <ПодстрокаЗамены>, <ИгнорироватьРегистр>, <МногострочныйПоиск>)

Параметры:

<Строка> (обязательный)

Тип: Строка.
Исходная строка.

<РегулярноеВыражение> (обязательный)

Тип: Строка.
Регулярное выражение.

<ПодстрокаЗамены> (обязательный)

Тип: Строка.
Строка, на которую выполняется замена. Может содержать ссылки на группы, описанные в параметре <РегулярноеВыражение>. Для ссылок на группы используется формат $0,$1...$n, где n - количество групп в регулярном выражении.

<ИгнорироватьРегистр> (необязательный)

Тип: Булево.
Истина - без учета регистра, Ложь - с учетом регистра.
Значение по умолчанию: Ложь.

<МногострочныйПоиск> (необязательный)

Тип: Булево.
Истина - выполняется многострочный поиск: символу "^" в шаблоне регулярного выражения соответствует начало каждой строки значения параметра <Строка>, символу "$" - конец каждой строки.

Ложь - символу "^" в шаблоне регулярного выражения соответствует начало значения в параметре <Строка>, символу "$" - конец текста.
Значение по умолчанию: Ложь.

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

Тип: Строка.
Строка, полученная в результате замены.

Описание:

Находит в исходной строке все вхождения регулярного выражения и заменяет их на подстроку замены.

Доступность:

Сервер, толстый клиент, внешнее соединение.

Пример:

// Заменить буквы из указанного набора на звездочку 

// из "Спрятать символы" в "*пря*а*ь *имволы"


Текст = "Спрятать символы";
РегулярноеВыражение = "С|с|т";
Результат =
    СтрЗаменитьПоРегулярномуВыражению(Текст, РегВыражение, "*");

// Преобразовать формат номера телефона

// из +7-123-456-7890 в +7 (123) 456 7890


Номер = "7-123-456-7890";
РегВыражениеНомера = "(\+7)(-)(\d{3})(-)(\d{3})(-)(\d{4})";
ФорматНомера = СтрЗаменитьПоРегулярномуВыражению(Номер, 
            РегВыражениеНомера, "$0 преобразована в $1 ($3) $5 $7");

Использование в версии:

Доступен, начиная с версии 8.3.23.


     Методическая информация