Dplreplace: Difference between revisions

From DynamicPageList3 Manual
Content added Content deleted
imported>FrozenPlum
m (Fix these to have working examples and add a note to come back to this)
imported>FrozenPlum
(Examples to subpages and linked to and preloaded for basic sandboxing on user subpage.)
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{DPL manual|section=dplreplace}}
{{DPL manual|section=dplreplace}}


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


This DPL3 module replaces a given <code>''pattern''</code> withing given <code>''text''</code> by the given <code>''replacement''</code>.
==Effect==
Replaces the given ''pattern'' within the ''text'' by ''replacement''.


⚫
''pattern'' is a regular expression as defined by php <code>preg_replace()</code>.


⚫
==Syntax==
⚫
''replacement'' may contain references to matching parts.
{{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.


'''Note:''' {{regexpinfo}}


==Examples==
==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>
<pre>
{{#dplreplace:abrakadabra|ab|AB}}
{{#dplreplace:abrakadabra|ab|AB}}
</pre>
</pre>
Replaces "ab" with "AB".




'''Result:'''<br>
'''Example 2:'''
{{#lsth:Examples/Module: dplreplace (example 2)|Example}}
{{#dplreplace:abrakadabra|ab|AB}}
{{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}}


<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.}}


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


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


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

Latest revision as of 02:57, 11 April 2023

v·t·e
DPL3 Manual (Main Page)
General Use & Syntax, Parameter Quick Reference, Examples
Primary DPL Documentation
Other DPL Modules
dplchapter  •  dplvar  •  dplreplace  •  dplnum  •  dplmatrix
Handy characters

²{ (Alt+0 1 7 8 • {) • }² (} • Alt+0 1 7 8) • « (Alt+0 1 7 1) • » (Alt+0 1 8 7) • ¦ (Alt+0 1 6 6) •  Alt+0 1 8 2

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:

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}}

Retrieved from "https://dpl3.wikitide.org/wiki/Dplreplace?oldid=330"