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

== rep ==

将一个字符串重复''n''次，其本质为<code>string.rep</code>。

用法：

: <code><nowiki>{{#invoke:</nowiki>String|rep|''源''|''次数''}}</code>

参数：

; 源
: 需要重复的字符串
; 次数
: 重复的次数

示例：

* <code><nowiki>"{{#invoke:String|rep|hello|3}}"</nowiki></code> → "{{#invoke:String|rep|hello|3}}"
* <code><nowiki>"{{#invoke:String|rep| hello | 3 }}"</nowiki></code> → "{{#invoke:String|rep| hello | 3 }}"
<!--

以下函数暂时还不存在，故移除有关的文档：
== escapePattern ==

在[[:mw:Special:MyLanguage/LUAREF#Patterns|模式]]中，将''类字符'''替换为''字面字符''。例如，在模式中，字符<code>.</code>会捕获任何字符，escapePattern会将其转换为<code>%.</code>，这样就捕获了字面字符“.”。

用法：
* <code><nowiki>{{#invoke:String|escapePattern|</nowiki>''模式字符串''<nowiki>}}</nowiki></code>

参数：

; 模式字符串
: 需要转义的模式字符串

示例：

* <code><nowiki>"{{#invoke:String|escapePattern|A.D.}}"</nowiki></code> → "{{#invoke:String|escapePattern|A.D.}}"
* <code><nowiki>"{{#invoke:String|escapePattern|10%}}"</nowiki></code> → "{{#invoke:String|escapePattern|10%}}"

== count == 
返回指定的模式的次数。返回不会将匹配交连。

用法：
: <code><nowiki>{{#invoke:</nowiki>String|count|''源字符串''|''匹配字符串''|''纯标记''}}</code>

或

: <code><nowiki>{{#invoke:</nowiki>String|count|source= ''源字符串'' |pattern= ''匹配字符串''|plain= ''纯标记'' }}</code>
参数：
; source_string
: 在此字符串内数出现次数
; pattern
: 在源内需要数的字符串或者模式
; plain
: 布尔值标记，表示目的应该被理解为纯文本，而不是[[mw:Special:MyLanguage/Extension:Scribunto/Lua reference manual#Ustring patterns|Scribunto ustring模式]]，默认为true

示例：
* 数“a”：<code><nowiki>"{{#invoke:String|count|aabbcc|a}}"</nowiki></code> → "{{#invoke:String|count|aabbcc|a}}"
* 数“aba”出现的次数：<code><nowiki>"{{#invoke:String|count|ababababab|aba}}"</nowiki></code> → "{{#invoke:String|count|ababababab|aba}}"
* 数a或c出现的次数：<code><nowiki>"{{#invoke:String|count|aabbcc|[ac]|plain=false}}"</nowiki></code> → "{{#invoke:String|count|aabbcc|[ac]|plain=false}}"
* 数非a出现的次数：<code><nowiki>"{{#invoke:String|count|aaabaaac|[^a]|plain=false}}"</nowiki></code> → "{{#invoke:String|count|aaabaaac|[^a]|plain=false}}"
* 数开头的a出现的次数：<code><nowiki>"{{#invoke:String|count|aaabaaac|^a|plain=false}}"</nowiki></code> → "{{#invoke:String|count|aaabaaac|^a|plain=false}}"

== join ==
将传入的所有字符串连成一个字符串，第一个字符串表示分隔符

用法：
: <code><nowiki>{{#invoke:</nowiki>String|join|''分隔符''|''字符串1''|''字符串2''|...}}</code>
参数：
; 分隔符
: 被连接在一起的各个字符串之间的字符串
: 注意对此参数，开头和结尾的空格不会被移除。
; 字符串1/字符串2/...
: 需要连接进来的字符串
示例：
* <code><nowiki>"{{#invoke:String|join|x|foo|bar|baz}}"</nowiki></code> → "{{#invoke:String|join|x|foo|bar|baz}}"
* <code><nowiki>"{{#invoke:String|join||a|b|c|d|e|f|g}}"</nowiki></code> → "{{#invoke:String|join||a|b|c|d|e|f|g}}"
* <code><nowiki>"{{#invoke:String|join|,|a|b|c|d|e|f|g}}"</nowiki></code> → "{{#invoke:String|join|,|a|b|c|d|e|f|g}}"
* <code><nowiki>"{{#invoke:String|join|, |a|b|c|d|e|f|g}}"</nowiki></code> → "{{#invoke:String|join|, |a|b|c|d|e|f|g}}"
* <code><nowiki>"{{#invoke:String|join| &ndash; |a|b|c|d|e|f|g}}"</nowiki></code> → "{{#invoke:String|join| &ndash; |a|b|c|d|e|f|g}}"
前面的这个例子使用了html实体&amp;ndash;，但是unicode字符也是有用的。

== endswith ==
{{for|startswith函数|Module:String2#startswith}}
用法：
: <code><nowiki>{{#invoke:</nowiki>String|endswith|''源字符串''|''搜索字符串''}}</code>

或

: <code><nowiki>{{#invoke:</nowiki>String|endswith|source= ''源字符串'' |pattern= ''搜索字符串''}}</code>
如果源字符串是以指定的搜索字符串结尾的，返回yes。使用命名参数会移除掉空格。''搜索字符串''不是个Lua模式，而是按照字面解释的。

* <code><nowiki>"{{#invoke:String|endswith|xxxyyy|y}}"</nowiki></code> → "{{#invoke:String|endswith|xxxyyy|y}}"
* <code><nowiki>"{{#invoke:String|endswith|xxxyyy|z}}"</nowiki></code> → "{{#invoke:String|endswith|xxxyyy|z}}"