Banri: Created page with "{{Documentation}} Acts as a regex-supporting version of `{{#replace:}}`. Some functions of standard regex (Perl compatible) are not supported. * N..."

2020-02-17T19:38:55Z

Created page with "{{Documentation}} Acts as a regex-supporting version of <code><nowiki>{{#replace:}}</nowiki></code>. Some functions of standard regex (Perl compatible) are not supported. * N..."

New page

{{Documentation}}
Acts as a regex-supporting version of <code><nowiki>{{#replace:}}</nowiki></code>.

Some functions of standard regex (Perl compatible) are not supported.
* No flags (<code>g</code>, <code>i</code>, <code>m</code>)
* No alteration (<code>|</code>); see below
* No generalized quantifier (<code>{m,n}</code>)
* No word boundaries (<code>\b</code>)

Lua's pattern matching is used for this template; however, the following replacements are made to give some functionality to standard regex:

* <code>*?</code> → <code>-</code>
* <code>\</code> → <code>%</code>
* <code>$1</code> → <code>%1</code> (supported for all numbers 1–9)

Any whitespace in the output will be automatically trimmed and condensed. Any HTML entities (such as <code>&#39;</code> from <code><nowiki>{{subst:PAGENAME}}</nowiki></code>) will be automatically converted to their actual character.

;Alteration
If detected, the module can emulate very simple alteration patterns within groups, with the following limitations:
* No supported for nested grouping (e.g. <code>(foo|bar(and|or)baz)</code>
** Escaped parentheses should work properly inside grouping (e.g. <code>(foo|bar$or$baz)</code>)
* <code>$</code> will cause unwanted behaviour inside any groups, even if that group doesn't use alteration
** This only applies to patterns where at least 1 group has an alteration. If all groups are single captures, this behaviour won't occur.
* The pipe character breaks wikitext. Use <code><nowiki>{{!}}</nowiki></code> or <code>¦</code> inside patterns

;MediaWiki docs
For full information on the difference between Lua's pattern matching and regex, see [[mw:Extension:Scribunto/Lua reference manual#Patterns|Lua reference manual § Patterns]].

;Usage
This template should always be substituted.
<pre>
{{subst:replace|text to perform on|search pattern|replacement}}
</pre>

;Examples
:<code><nowiki>{{subst:replace|textcapturetext|text(.*)text|$1}}</nowiki></code> → <code>capture</code>
::Expected: <code>capture</code>

:<code><nowiki>{{subst:replace|Abyssal whip detail.png|detail\.png}}</nowiki></code> → <code>Abyssal whip</code>
::Expected: <code>Abyssal whip</code>

: <code><nowiki>{{replace|abcde|(ab¦c¦d)|^$1^}}</nowiki></code> → <code>{{replace|abcde|(ab¦c¦d)|^$1^}}</code>
::Expected: <code>^ab^^c^^d^e</code>

: <code><nowiki>{{replace|abcde|(a¦b¦d)|$$1###-}}</nowiki></code> → <code>{{replace|abcde|(a¦b¦d)|$$1###-}}</code>
::Expected: <code>$a###-$b###-c$d###-e</code>

: <code><nowiki>{{replace|abcde|(ab¦a¦b)|!$1!}}</nowiki></code> → <code>{{replace|abcde|(ab¦a¦b)|!$1!}}</code>
::Expected: <code>!ab!cde</code>

<includeonly>[[Category:Formatting templates]]</includeonly>

Template:Replace/doc - Revision history

Banri: Created page with "{{Documentation}} Acts as a regex-supporting version of {{#replace:}}. Some functions of standard regex (Perl compatible) are not supported. * N..."

Banri: Created page with "{{Documentation}} Acts as a regex-supporting version of `{{#replace:}}`. Some functions of standard regex (Perl compatible) are not supported. * N..."