Dplreplace: Difference between revisions

Line 2:

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

⚫

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

==Syntax==

{{syntax|{{#dplreplace:''text''{{!}}''pattern''{{!}}''replacement''}}}}, where:

<pre>

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

</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:'''

⚫

'''Result 1:'''

<pre>

</pre>

Replaces "ab" with "AB". This is the basic usage without using regular expressions as pattern. '''Matches''': "ab", "ab".

⚫

'''Result:'''~~ ~~

'''Example 2:'''

<pre>

</pre>

Replaces "a" ''and the following characters until the next "r"'' with "A". This example uses a regular expression as pattern, indicated by the "/", and is using the lookahead syntax "?" to find the "r". '''Matches''', with the group match in (): "a(br)", "a(kadabr)".

'''Result:'''

'''Result 3:'''

'''Example 3:'''

<pre>

</pre>

Replaces "a" with "A" if there is an "r" somewhere after the "a". The "\1" references the group found between the "a" and "r" and puts it back into the replaced string. '''Matches''', with the group match in (): "a(br)", "a(kadabr)".

'''Result:'''

'''Result 3:'''

'''Example 4:'''

<pre>

</pre>

Replaces "a" with "A" if there is an "r" somewhere after the "a" and also replaces the "r" at the end of/outside the found group(s) with "_r_". '''Matches''', with the group match in (): "a(b)r", "a(kadab)r".

'''Result:'''

'''Result 4:'''

[[Category:Other Modules]]