Dplreplace: Difference between revisions

Content added Content deleted

Inline

Latest revision as of 02:57, 11 April 2023

Manual	dplreplace

This DPL3 module replaces a given pattern withing given text by the given replacement.

Syntax

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

text is whatever text is to be searched within.
pattern is a regular expression as defined by php preg_replace().
replacement may contain references to matching parts.

Note: If you are not familiar with regular expressions and/or do not know the specifics of Perl regexp used in PHP, it may be helpful to see:

The PHP manual and W3Schools for more information.
RegExr for testing regular expressions.

Examples

Example 1: {{#lsth:Examples/Module: dplreplace (example 1)|Example}}

Page Template:ViewTest/style.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text").

Test in sandbox

View Result

Result 1: {{#lsth:Examples/Module: dplreplace (example 1)|Result}}

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

Example 2: {{#lsth:Examples/Module: dplreplace (example 2)|Example}}

Page Template:ViewTest/style.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text").

Test in sandbox

View Result

Result 3:
{{#lsth:Examples/Module: dplreplace (example 2)|Result}}

Example 3: {{#lsth:Examples/Module: dplreplace (example 3)|Example}}

Page Template:ViewTest/style.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text").

Test in sandbox

View Result

Result 3:
{{#lsth:Examples/Module: dplreplace (example 3)|Result}}

Example 4: {{#lsth:Examples/Module: dplreplace (example 4)|Example}}

Page Template:ViewTest/style.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text").

Test in sandbox

View Result

Result 4:
{{#lsth:Examples/Module: dplreplace (example 4)|Result}}

@@ Line 1: / 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><nowiki>
+* <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>.
-</nowiki></pre>
+* <code>''replacement''</code> may contain references to matching parts.
+'''Note:''' {{regexpinfo}}
+==Examples==
+'''Example 1:'''
+{{#lsth:Examples/Module: dplreplace (example 1)|Example}}
+{{ViewTest|Examples|Module: dplreplace (example 1)}}
+'''Result 1:'''
+{{#lsth:Examples/Module: dplreplace (example 1)|Result}}
+<pre>
+{{#dplreplace:abrakadabra|ab|AB}}
+</pre>
+'''Example 2:'''
+{{#lsth:Examples/Module: dplreplace (example 2)|Example}}
+{{ViewTest|Examples|Module: dplreplace (example 2)}}
+'''Result 3:'''<br>
-==Effect==
+{{#lsth:Examples/Module: dplreplace (example 2)|Result}}
-Replaces the given ''pattern'' within the ''text'' by ''replacement''.
-''pattern'' is a regular expression as defined by php <code>preg_replace()</code>.
+'''Example 3:'''
-''replacement'' may contain references to matching parts.
+{{#lsth:Examples/Module: dplreplace (example 3)|Example}}
+{{ViewTest|Examples|Module: dplreplace (example 3)}}
+'''Result 3:'''<br>
-==Example==
+{{#lsth:Examples/Module: dplreplace (example 3)|Result}}
- <nowiki> {{#dplreplace:abrakadabra|ab|AB}} </nowiki>    returns:   {{#dplreplace:abrakadabra|ab|AB}}
- <nowiki> {{#dplreplace:abrakadabra|/a(.*?)r/|A\1_r_}} </nowiki> returns:   {{#dplreplace:abrakadabra|/a(.*?)r/|A\1_r_}}
+'''Example 4:'''
-The second example only replaces "a" by "A" if there is an "r" somewhere after the "a".
+{{#lsth:Examples/Module: dplreplace (example 4)|Example}}
+{{ViewTest|Examples|Module: dplreplace (example 4)}}
+'''Result 4:'''<br>
-<!-- Extension prefix in other languages:
+{{#lsth:Examples/Module: dplreplace (example 4)|Result}}
+[[Category:Other Modules]]
-[[de:Erweiterung:{{subst:BASEPAGENAME}}]]
-[[es:Extensión:{{subst:BASEPAGENAME}}]]
-[[fr:Extension:{{subst:BASEPAGENAME}}]]
-[[it:Estensione:{{subst:BASEPAGENAME}}]]
-[[nl:Uitbreiding:{{subst:BASEPAGENAME}}]]
-[[pl:Rozszerzenie:{{subst:BASEPAGENAME}}]]
-[[pt::Extension:{{subst:BASEPAGENAME}}]]
-[[ru:Расширение:{{subst:BASEPAGENAME}}]]
-[[zh:Extension::{{subst:BASEPAGENAME}}]]
--->