查看“模块:Loop/doc”的源代码

{{FromOther/CN|site=萌娘百科|originURL=https://zh.moegirl.org.cn/{{FULLPAGENAMEE}}|origin={{FULLPAGENAME}}|copyright=cc|lsubtype=by-nc-sa|lver=3.0|contribURL=https://zh.moegirl.org.cn/index.php?title={{FULLPAGENAMEE}}&action=history}}
== 简介 ==

该模块可以循环执行语句。相较于解析器函数，因为使用Lua模块进行循环，所以'''没有100次上限的限制'''。

用法和功能与{{tl|loop}}类似，但可以处理模板的接收参数（也即被三对大括号包裹的参数，如<code><nowiki>{{{1}}}</nowiki></code>）

== 用法 ==
注意：
* 第一层循环的代码需要用<code><nowiki><nowiki></nowiki></code>标签包裹。
* 多层循环中内层循环的代码不需要<code><nowiki><nowiki></nowiki></code>标签包裹。
;loop
<pre>
{{#invoke:loop|main| 自增/减变量名 = 初始值 | 最大值 | 自增/减量 |do= <nowiki><nowiki></nowiki>
循环执行的代码...
<nowiki></nowiki></nowiki>}}
</pre>
*<code>main</code>亦可作<code>loop</code>、<code>for</code>。
*使用自增/减变量的写法为：<code><nowiki>{{#var:变量名}}</nowiki></code>，如：<code><nowiki>{{#var:time}}</nowiki></code>。
*默认的自增/减量在初始值小于最大值为1，在初始值大于最大值时为-1。
;while/dowhile
<pre>
{{#invoke:loop|while| condition = <nowiki><nowiki></nowiki>循环条件<nowiki></nowiki></nowiki> |do= <nowiki><nowiki></nowiki>
循环执行的代码...
<nowiki></nowiki></nowiki>}}
</pre>
<pre>
{{#invoke:loop|dowhile| condition = <nowiki><nowiki></nowiki>循环条件<nowiki></nowiki></nowiki> |do= <nowiki><nowiki></nowiki>
循环执行的代码...
<nowiki></nowiki></nowiki>}}
</pre>
;fornumargs
<pre>
{{#invoke:loop|fornumargs| 变量名前缀 | 索引变量名 | 值变量名 |<nowiki><nowiki></nowiki>
循环执行的代码...
<nowiki></nowiki></nowiki>}}
</pre>
*具体使用方法可参考[[Help:魔术字/解析器函数#循环]]中的相关介绍。

== 示例 ==
=== 示例1 ===
<pre>
{{#vardefine:count|0}}<!--
-->{{#invoke:loop|main|time=1|101|do=
<nowiki><nowiki></nowiki>{{#vardefine:count| {{#expr: {{#var:count}} + {{#var:time}} }} }}<nowiki></nowiki></nowiki> }}
结果：{{#var:count}}
</pre>
{{#vardefine:count|0}}<!--
-->{{#invoke:loop|main|time=1|101|do=
<nowiki>{{#vardefine:count| {{#expr: {{#var:count}} + {{#var:time}} }} }}</nowiki> }}
结果：{{#var:count}}

=== 示例2 ===
<pre>
{{#vardefine:count|0}}<!--
-->{{#invoke:loop|main|time1=1|5|do=<nowiki><nowiki></nowiki>
  {{#invoke:loop|main|time2=1|100|do=
    {{#vardefine:count| {{#expr: {{#var:count}} + {{#var:time1}} * {{#var:time2}} }} }}
  }}
<nowiki></nowiki></nowiki>}}
结果：{{#var:count}}
</pre>
{{#vardefine:count|0}}<!--
-->{{#invoke:loop|main|time1=1|5|do=<nowiki>
  {{#invoke:loop|main|time2=1|100|do=
    {{#vardefine:count| {{#expr: {{#var:count}} + {{#var:time1}} * {{#var:time2}} }} }} 
  }}
</nowiki>
}}
结果：{{#var:count}}

=== 示例3 ===
<pre>
{{#invoke:loop|main|time=1|5
|do=<nowiki><nowiki></nowiki>
{{#expr:{{#var:time}} + {{{1|0}}} }}{{{split|、}}}
<nowiki></nowiki></nowiki>
}}
</pre>

{{#invoke:loop|main|time=1|5
|do=<nowiki>
{{#expr:{{#var:time}} + {{{1|0}}} }}{{{split|、}}}
</nowiki>
}}