编辑“︁模块:String/doc”︁（章节）

== replace（gsub） ==

此函数在一个字符串内替换到目的字符串或者模式。此函数是通过调用<code>mw.ustring.gsub</code>实现的。

用法：

: <code><nowiki>{{#invoke:</nowiki>String|replace|''源字符串''|''模式字符串''|''替换字符串''|''替换次数''|''纯标记''}}</code>

或

: <code><nowiki>{{#invoke:</nowiki>String|replace|source= ''源字符串'' |pattern= ''模式字符串'' |replace= ''替换字符串'' |count= ''替换次数'' |plain= ''纯标记'' }}</code>

参数：

; source
: 在此字符串内搜索
; pattern
: 在源内查找此字符串或者模式
; replace
: 使用此字符串替换
; count
: 需要替换的次数，默认为all
; plain
: 布尔值标记，表示目的应该被理解为纯文本，而不是[[mw:Special:MyLanguage/Extension:Scribunto/Lua reference manual#Ustring patterns|Scribunto ustring模式]]，默认为true

示例：

* <code><nowiki>"{{#invoke:String|replace| abc123def456 |123|XYZ}}"</nowiki></code> → "{{#invoke:String|replace| abc123def456 |123|XYZ}}"
* <code><nowiki>"{{#invoke:String|replace|source= abc123def456 |pattern= 123 |replace= XYZ }}"</nowiki></code> → "{{#invoke:String|replace|source= abc123def456 |pattern= 123 |replace= XYZ }}"
* <code><nowiki>"{{#invoke:String|replace| abc123def456 |%d+|XYZ|1|false}}"</nowiki></code> → "{{#invoke:String|replace| abc123def456 |%d+|XYZ|1|false}}"
* <code><nowiki>"{{#invoke:String|replace|source= abc123def456 |pattern= %d+ |replace= XYZ |count=1 |plain= false }}"</nowiki></code> → "{{#invoke:String|replace|source= abc123def456 |pattern= %d+ |replace= XYZ |count=1 |plain= false }}"
* <code><nowiki>"{{#invoke:String|replace|source= abc123def456 |pattern= %d+ |replace= XYZ |plain= false }}"</nowiki></code> → "{{#invoke:String|replace|source= abc123def456 |pattern= %d+ |replace= XYZ |plain= false }}"
* <code><nowiki>{{#invoke:String|replace|source= 0012001200 |pattern= ^0* |plain= false }}</nowiki></code> → {{#invoke:String|replace|source= 0012001200 |pattern= ^0* |plain= false }}