Dplreplace: Difference between revisions

Examples to subpages and linked to and preloaded for basic sandboxing on user subpage.
miraheze:dpl3>Soukupmi
(→‎Examples: breaking example 2 into 2 separate ones)
imported>FrozenPlum
(Examples to subpages and linked to and preloaded for basic sandboxing on user subpage.)
 
(4 intermediate revisions by 2 users not shown)
Line 1:
{{DPL manual|section=dplreplace}}
 
 
This DPL3 module replaces a given <code>''pattern''</code> withing given <code>''text''</code> by the given <code>''replacement''</code>.
 
 
==Syntax==
{{syntax|&#123;&#123;#dplreplace:''text''{{!}}''pattern''{{!}}''replacement''&#125;&#125;}}, where:
<pre>
* <code>''text''</code> is whatever text is to be searched within.
{{#dplreplace:text|pattern|replacement}}
* <code>''pattern''</code> is a regular expression as defined by php <code>preg_replace()</code>.
</pre>
* <code>''replacement''</code> may contain references to matching parts.
 
==Effect==
Replaces the given ''pattern'' within the ''text'' by ''replacement''.
 
'''Note:''' {{regexpinfo}}
''pattern'' is a regular expression as defined by php <code>preg_replace()</code>.
 
''replacement'' may contain references to matching parts.
 
==Examples==
 
'''Example 1:'''
{{#lsth:Examples/Module: dplreplace (example 1)|Example}}
{{ViewTest|Examples|Module: dplreplace (example 1)}}
 
'''Result 1:'''<br>
{{#lsth:Examples/Module: dplreplace (example 1)|Result}}
<pre>
{{#dplreplace:abrakadabra|ab|AB}}
</pre>
Replaces "ab" with "AB".
 
'''Result:'''<br>
{{#dplreplace:abrakadabra|ab|AB}}
 
 
'''Example 2:'''
{{#lsth:Examples/Module: dplreplace (example 2)|Example}}
<pre>
{{ViewTest|Examples|Module: dplreplace (example 2)}}
{{#dplreplace:abrakadabra|/a(.*?)r/|A\1r}}
</pre>
Replaces "a" by "A" if there is an "r" somewhere after the "a". The "\1r" part is needed to put back the original text into the replaced string.<br>
<code><nowiki>{{#dplreplace:abrakadabra|/a(.*?)r/|A}}</nowiki></code> (without the "\1r") would otherwise lead to "{{#dplreplace:abrakadabra|/a(.*?)r/|A}}".
 
'''Result 3:'''<br>
{{#lsth:Examples/Module: dplreplace (example 2)|Result}}
{{#dplreplace:abrakadabra|/a(.*?)r/|A\1r}}
 
 
'''Example 3:'''
{{#lsth:Examples/Module: dplreplace (example 3)|Example}}
<pre>
{{ViewTest|Examples|Module: dplreplace (example 3)}}
{{#dplreplace:abrakadabra|/a(.*?)r/|A\1_r_}}
 
</pre>
'''Result 3:'''<br>
Replaces "a" by "A" if there is an "r" somewhere after the "a" and also replaces the "r" at the end of the found group(s) by "_r_".
{{#lsth:Examples/Module: dplreplace (example 3)|Result}}
<!--{{note|This explanation is incomplete, it needs to be expanded to better explain what is taking place in the result.}}-->
 
 
'''Example 4:'''
{{#lsth:Examples/Module: dplreplace (example 4)|Example}}
{{ViewTest|Examples|Module: dplreplace (example 4)}}
 
'''Result 4:'''<br>
{{#lsth:Examples/Module: dplreplace (example 4)|Result}}
{{#dplreplace:abrakadabra|/a(.*?)r/|A\1_r_}}
 
[[Category:Other Modules]]
Anonymous user