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}}
+{{DPL manual|section=dplreplace}}
-=== Syntax ===
+This DPL3 module replaces a given <code>''pattern''</code> withing given <code>''text''</code> by the given <code>''replacement''</code>.
-<pre><nowiki>
-  {{#dplreplace:text|pattern|replacement}}
-</nowiki></pre>
-=== Effect ===
+==Syntax==
- Replaces the given ''pattern'' within the ''text'' by ''replacement''.
+{{syntax|&#123;&#123;#dplreplace:''text''{{!}}''pattern''{{!}}''replacement''&#125;&#125;}}, where:
+* <code>''text''</code> is whatever text is to be searched within.
+* <code>''pattern''</code> is a regular expression as defined by php <code>preg_replace()</code>.
+* <code>''replacement''</code> may contain references to matching parts.
-''pattern'' is a regular expression as defined by php <code>preg_replace()</code>.
+'''Note:''' {{regexpinfo}}
-''replacement'' may contain references to matching parts.
-=== Example ===
+==Examples==
+'''Example 1:'''
- <nowiki> {{#dplreplace:abrakadabra|ab|AB}} </nowiki>    returns:   {{#dplreplace:abrakadabra|ab|AB}}
+{{#lsth:Examples/Module: dplreplace (example 1)|Example}}
+{{ViewTest|Examples|Module: dplreplace (example 1)}}
+'''Result 1:'''
- <nowiki> {{#dplreplace:abrakadabra|/a(.*?)r/|A\1_r_}} </nowiki> returns:   {{#dplreplace:abrakadabra|/a(.*?)r/|A\1_r_}}
+{{#lsth:Examples/Module: dplreplace (example 1)|Result}}
+<pre>
+{{#dplreplace:abrakadabra|ab|AB}}
+</pre>
-The second example only replaces "a" by "A" if there is an "r" somewhere after the "a".
+'''Example 2:'''
-[[Category:DPL Manual]]
+{{#lsth:Examples/Module: dplreplace (example 2)|Example}}
+{{ViewTest|Examples|Module: dplreplace (example 2)}}
+'''Result 3:'''<br>
+{{#lsth:Examples/Module: dplreplace (example 2)|Result}}
+'''Example 3:'''
+{{#lsth:Examples/Module: dplreplace (example 3)|Example}}
+{{ViewTest|Examples|Module: dplreplace (example 3)}}
+'''Result 3:'''<br>
+{{#lsth:Examples/Module: dplreplace (example 3)|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}}
+[[Category:Other Modules]]