查看“︁Template:Replace/doc”︁的源代码

== 简介 ==

该模板根据传入的正则表达式对字符串进行替换，并返回相应的捕获物以及匹配次数。

== 用法 ==

<pre>
{{replace|str= 字符串(string)|ptn= 正则(pattern)，支持以<nowiki>标签包裹的格式传入
|rep= 要替换的内容(replace)，默认为直接替换掉（也就是替换为空）
|spl= 捕获物间隔符(split)，默认为顿号
|lim= 匹配次数限制(limit)，默认无限制
|ori= 匹配的字符串起点(origin)，默认为从头匹配
|noprint= 为“true”时，不输出匹配结果，改为将结果赋给变量“result”
}}
</pre>

其中，捕获物保存在变量<code>result.capture</code>中，匹配次数保存在变量<code>result.count</code>中。

捕获物默认为正则表达式中第一个子表达式，若未定义，则为匹配到的整个子串。

以上列出的参数除<code>noprint</code>也一一对应匿名参数1~6，注意命名参数与匿名参数不要混用。

由于用来存储结果的变量名都是固定的，请在获得结果后立即使用或转存到其他变量中。

== 示例 ==

=== 示例1 ===
<pre>
{{replace|str=1@2@3|ptn=@|rep=、}}

{{#var:result.count}}

{{#var:result.capture}}
</pre>

'''结果'''：

{{replace|str=1@2@3|ptn=@|rep=、}}

{{#var:result.count}}

{{#var:result.capture}}

=== 示例2 ===
<pre>
{{replace|str=1,2,3|ptn=(%d)|rep=数字|spl= =>|noprint=true}}
{{#var:result.count}}

{{#var:result.capture}}

{{#var:result}}
</pre>

'''结果'''：

{{replace|str=1,2,3|ptn=(%d)|rep=数字|spl= =>|noprint=true}}
{{#var:result.count}}

{{#var:result.capture}}

{{#var:result}}

=== 示例3 ===
<pre>
{{replace
|str=《'''{{lj|パーフェクト生命}}'''》（完美生命）是{{lj|[[ナユタン星人]]}}于2015年10月6日投稿至[[niconico]]、后分别转投至YouTube和bilibili的[[VOCALOID]]日文原创歌曲，由[[初音未来]]演唱。该曲是{{lj|ナユタン星人}}投稿的第四首曲子，目前该曲收录在第一部专辑{{lj|[[ナユタン星からの物体X]]}}中。
|ptn=%[%[.-%]%]
|noprint=true
}}<!--
-->{{split|{{#var:result.capture}}|、|link}}<!--
-->这个句子中共出现了{{#var:result.count}}个链接，它们分别是：{{loop|time=1|{{#var:result.count}}
|do=<nowiki><nowiki></nowiki>'''{{#var:link{{#var:time}}}}'''、<nowiki></nowiki></nowiki>
}}
</pre>

这里实现了一个收集字符串中的链接并加粗后重新显示的功能。

'''结果'''：
{{replace
|str=《'''{{lj|パーフェクト生命}}'''》（完美生命）是{{lj|[[ナユタン星人]]}}于2015年10月6日投稿至[[niconico]]、后分别转投至YouTube和bilibili的[[VOCALOID]]日文原创歌曲，由[[初音未来]]演唱。该曲是{{lj|ナユタン星人}}投稿的第四首曲子，目前该曲收录在第一部专辑{{lj|[[ナユタン星からの物体X]]}}中。
|ptn=%[%[.-%]%]
|noprint=true
}}<!--
-->{{split|{{#var:result.capture}}|、|link}}<!--
-->这个句子中共出现了{{#var:result.count}}个链接，它们分别是：{{loop|time=1|{{#var:result.count}}
|do=<nowiki>'''{{#var:link{{#var:time}}}}'''、</nowiki>
}}

<includeonly>[[分类:字符串模板]]</includeonly>
<noinclude>[[Category:模板文档]]</noinclude>