编辑“︁模块:String/doc”︁

'''由{{N|9}}汉化于MediaWiki Module:String/doc，删去了前言和配置手册，有更改'''

本模块添加了简单的字符串函数。

== <code>len</code> ==

此函数返回字符串的长度。

范例：<code><nowiki>{{#invoke:String|len|目标字符串}}</nowiki></code>

== <code>sub</code> ==

本函数返回目标函数的指定段落。请注意，首个字符的编号为'''1'''而非'''0'''。

范例：<code><nowiki>{{#invoke:String|sub|目标字符串|起始位置|结束位置}}</nowiki></code>

* 起始位置和结束位置为数字。填入负数代表反向索引，例如-1代表字符串的最后一个字符。

== <code>match</code> ==

本函数可以用于检查A字符串里是否含有B字符串。

范例：<code><nowiki>{{#invoke:String|match|被索引字符串|索引字符串|起始位置|需要匹配次数|字符串类型|错误输出}}</nowiki></code>

<s>不知道为什么没有提供“结束位置”的选项设置</s>

* 如果被索引字符串里含有索引字符串，则返回索引字符串；若不含，则返回错误输出，若没有错误输出，则报错。
* ''需要匹配次数''：如果被索引字符串里需要含有指定次数次索引字符串，则返回索引字符串，若没有达到次数则返回错误输出，若没有错误输出，则报错。本项默认为'''1'''。
* ''字符串类型''：Boolean flag indicating that pattern should be understood as plain text and not as a Lua-style regular expression. Defaults to false.
* ''错误输出''：当函数报错时的输出，省去了使用<nowiki>{{#iferror}}</nowiki>的步骤。

== <code>pos</code> ==

本函数返回指定字符串里的指定位置的数据。

范例：<code><nowiki>{{#invoke:String|pos|目标字符串|位置}}</nowiki></code>

* 位置为数字。填入负数代表反向索引，例如-1代表字符串的最后一个字符。

== <code>find</code>==

本函数返回A字符串里包含的B字符串的位置。

范例：<code><nowiki>{{#invoke:String|find|被查找字符串|查找字符串|起始位置|字符串类型}}</nowiki></code>

<s>不知道为什么没有提供“结束位置”的选项设置</s>

* 如果被查找字符串里含有查找字符串，则返回被查找字符串里第一次查找到查找字符串的第一个字符的位置。如果没有，返回'''0'''。
* ''起始位置''：为数字，填入负数代表反向索引，例如-1代表字符串的最后一个字符。只能查找被查找字符串的指定起始位置(含)之后的位置，默认为'''1'''。
* ''字符串类型''：Boolean flag indicating that target should be understood as plain text and not as a Lua-style regular expression, defaults to true.

==<code>replace</code>==

本函数可以将A字符串内的B字符串替换为C字符串。

范例：<code><nowiki>{{#invoke:String|replace|A字符串|B字符串|C字符串|替换数量|字符串类型}}</nowiki></code>

* A字符串：被替换的字符串。
* B字符串：A字符串内被替换的文本。
* C字符串：替换A字符串内的B字符串的文本。
* 替换数量：从字符串头开始，替换指定次数，默认为'''all'''。
* 字符串类型：Boolean flag indicating that pattern should be understood as plain text and not as a Scribunto ustring pattern (a unicode-friendly Lua-style regular expression); defaults to true.

==<code>rep</code>==

本函数可以将指定字符串重复指定次数。

范例：<code><nowiki>{{#invoke:String|rep|指定字符串|重复次数}}</nowiki></code>