「モジュール:String/doc」を編集中 (節単位)

=== replace ===
パターンと一致する部分を別の文字列で置き換えます。
<syntaxhighlight lang="moin">
{{#invoke:String|replace|文字列|パターン|置換文字列|置換回数|プレーンフラグ}}
</syntaxhighlight>
もしくは
<syntaxhighlight lang="moin">
{{#invoke:String|replace
|source=文字列
|pattern=パターン
|replace=置換文字列
|count=置換回数
|plain=プレーンフラグ
}}
</syntaxhighlight>

{| class="wikitable"
|+ 引数の一覧
! 引数 !! 内容 !! 既定値 !! 説明
|-
! source
| 文字列 || ''なし'' || 対象の文字列
|-
! pattern
| パターン || ''なし'' || 置換される文字列パターン
|-
! replace
| 置換文字列 || ''なし'' || 置換する文字列<br />何も指定しないとパターンを削除する（既定）
|-
! count
| 置換回数 || ''なし'' || 置換する回数<br />何も指定しないと可能な箇所すべてを置換する（既定）
|-
! plain
| プレーンフラグ || true ||
; false, no, 0, ''空文字'' : パターンを[[mw:Extension:Scribunto/Lua_reference_manual#Patterns|Luaパターン]]として解釈する
; trueなど上記以外の文字列 : パターンをプレーンテキストとして解釈する
|}

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