http://sfsys.ru/index.php?action=history&feed=atom&title=ReplaceREReplaceRE - Revision history2026-04-04T16:38:51ZRevision history for this page on the wikiMediaWiki 1.31.1http://sfsys.ru/index.php?title=ReplaceRE&diff=4703&oldid=prevAdmin: 1 revision imported2023-12-30T13:55:30Z<p>1 revision imported</p>
<table class="diff diff-contentalign-left" data-mw="interface">
<tr class="diff-title" lang="en">
<td colspan="1" style="background-color: #fff; color: #222; text-align: center;">← Older revision</td>
<td colspan="1" style="background-color: #fff; color: #222; text-align: center;">Revision as of 13:55, 30 December 2023</td>
</tr><tr><td colspan="2" class="diff-notice" lang="en"><div class="mw-diff-empty">(No difference)</div>
</td></tr></table>Adminhttp://sfsys.ru/index.php?title=ReplaceRE&diff=4702&oldid=prev1>Admin at 13:42, 30 December 20232023-12-30T13:42:47Z<p></p>
<p><b>New page</b></p><div>{{infobox function<br />
|name=ReplaceRE<br />
|caption=Функции для работы с регулярными выражениями<br />
|type=1<br />
|status=2<br />
|db=0<br />
|exception=Невозможно превратить в строку, число, синтаксическая ошибка в шаблоне<br />
|visual=0}}<br />
{{HeadLinks|<br />
* [[Main_Page|Начальная страница]]<br />
* [[Общее_описание_языка|Общее описание]]<br />
* [[Строковые функции]]}}<br />
Производит проверку шаблона регулярных выражений, заданного вторым аргументом в тексте, заданном первым аргументом. Возвращает текст, с заменой найденных в нем значений на текст или шаблон, заданный третьим аргументом.<br />
<br />
== Синтаксис ==<br />
<code><br />
'''ReplaceRE'''(''<Строка, в которой происходит поиск (STRING)>'',''<Выражение (STRING)>'',''<Шаблон для замены (STRING)>''{{Optional|,''<Позиция начала поиска (INT)>''{{Default|{{Eq}}0}},<Максимальное количество замен (INT)>''{{Default|{{Eq}}0}},<Флаги поиска (INT)>{{Default|{{Eq}}0}}}}):''<Текст результата (STRING)>''<br />
</code><br />
==== Аргументы ====<br />
* <code>''<Строка, в которой происходит поиск (STRING)>''</code> - Текст поиска.<br />
* <code>''<Выражение (STRING)>''</code> - Шаблон регулярного выражения для поиска в тексте.<br />
* <code>''<Шаблон для замены (STRING)>''</code> - Строка, которой будут заменяться найденные в тексте значения. Кроме текста для замены, аргумент может содержать специальные выражения, начинающиеся на символ '''$'''. Список таких выражений дан ниже:<br />
** '''$$''' -- при замене подставляется одиночный символ '''$'''.<br />
** '''$&''' -- при замене подставляется само найденное выражение в тексте поиска значение.<br />
** '''$`''' -- при замене подставляется часть исходного текста поиска с начала текста до позиции найденного значения.<br />
** '''$<nowiki>'</nowiki>''' -- при замене подставляется часть исходного текста поиска с символа, следующего непосредственно за найденным значением до конца текста.<br />
** '''$N''' -- при замене подставляется значение группы поиска с номером '''N'''. Нумерация групп начинается с 1 и задается в последовательности левых открывающихся скобок (это имеет значение только для вложенных групп). Если группа не участвовала в сравнении из-за предыдущего условия, либо создавала квантификацию с количеством ноль, будет подставлена пустая строка.<br />
** '''$<Group>''' -- при замене подставляется значение группы поиска с наименованием '''Group'''. Если группа не участвовала в сравнении из-за предыдущего условия, либо создавала квантификацию с количеством ноль, будет подставлена пустая строка.<br />
* <code>''<Позиция начала поиска (INT)>''</code> - {{Optional}} Позиция начала поиска (по умолчанию -- с начала текста).<br />
* <code>''<Максимальное количество замен (INT)>''</code> - {{Optional}} Аргумент задает максимальное количество производимых замен, после чего система не будет продолжать поиск и исходный текст с момента последней замены не будет изменен. По умолчанию '''0''' (без ограничений).<br />
* <code>''<Флаги поиска (INT)>''</code> - {{Optional}} Число - битовая маска режимов поиска по умолчанию. Имеет следующие биты:<br />
** '''бит 0''': Использовать регистро-независимый поиск (''1''), по умолчанию поиск будет регистро-зависимым. '''Важно:''' данный режим изменяет только сравнение обычного текста, сравнение наборов символов ('''[...]''') изменено не будет.<br />
** '''бит 1''': Не использовать конструкции проверки позиции '''$''' и '''^''', для нахождения начала и конца строки внутри текста, а только для нахождения начала и конца всего текста. По-умолчанию режим отключен.<br />
<br />
==== Возвращаемое значение ====<br />
Функция возвращает строку, результат замены.<br />
<br />
== Примеры ==<br />
<pre><br />
Стр:="The pink cockatoo is a medium-sized cockatoo that inhabits arid and semi-arid inland areas across Australia.";<br />
<br />
//Окружает слова the и that, вне зависимости от регистра, круглыми скобками.<br />
Message(ReplaceRE(Стр,"(?<grp>the|that)","($<grp>)",,0,1));<br />
<br />
//Будет выведено:<br />
//(The) pink cockatoo is a medium-sized cockatoo (that) inhabits arid and semi-arid inland areas across Australia.<br />
</pre></div>1>Admin