Dplreplace: Difference between revisions

From DynamicPageList3 Manual
Content added Content deleted
imported>FrozenPlum
mNo edit summary
imported>FrozenPlum
m (Fix these to have working examples and add a note to come back to this)
Line 2: Line 2:


==Syntax==
==Syntax==
<pre><nowiki>
<pre>
{{#dplreplace:text|pattern|replacement}}
{{#dplreplace:text|pattern|replacement}}
</nowiki></pre>
</pre>


==Effect==
==Effect==
Line 13: Line 13:
''replacement'' may contain references to matching parts.
''replacement'' may contain references to matching parts.


==Example==
==Examples==
<pre>
<nowiki> {{#dplreplace:abrakadabra|ab|AB}} </nowiki> returns: {{#dplreplace:abrakadabra|ab|AB}}
{{#dplreplace:abrakadabra|ab|AB}}
</pre>
Replaces "ab" with "AB".


<nowiki> {{#dplreplace:abrakadabra|/a(.*?)r/|A\1_r_}} </nowiki> returns: {{#dplreplace:abrakadabra|/a(.*?)r/|A\1_r_}}


'''Result:'''<br>
The second example only replaces "a" by "A" if there is an "r" somewhere after the "a".
{{#dplreplace:abrakadabra|ab|AB}}

<pre>
{{#dplreplace:abrakadabra|/a(.*?)r/|A\1_r_}}
</pre>
Replaces "a" by "A" if there is an "r" somewhere after the "a".
{{note|This explanation is incomplete, it needs to be expanded to better explain what is taking place in the result.}}


'''Result:'''<br>
{{#dplreplace:abrakadabra|/a(.*?)r/|A\1_r_}}


[[Category:Other Modules]]
[[Category:Other Modules]]

Revision as of 08:27, 5 April 2022

Manual dplreplace

Syntax

{{#dplreplace:text|pattern|replacement}}

Effect

Replaces the given pattern within the text by replacement.

pattern is a regular expression as defined by php preg_replace().

replacement may contain references to matching parts.

Examples

{{#dplreplace:abrakadabra|ab|AB}}

Replaces "ab" with "AB".


Result:
{{#dplreplace:abrakadabra|ab|AB}}

{{#dplreplace:abrakadabra|/a(.*?)r/|A\1_r_}}

Replaces "a" by "A" if there is an "r" somewhere after the "a".

This explanation is incomplete, it needs to be expanded to better explain what is taking place in the result.


Result:
{{#dplreplace:abrakadabra|/a(.*?)r/|A\1_r_}}