Donnyjie：Donnyjie移动页面帮助/解析器函数至帮助:解析器函数

2026-05-07T14:49:59Z

←上一版本		2026年5月7日 (四) 22:49的版本
（没有差异）

雨音伴嵩：新条目

2018-08-22T00:26:08Z

新条目

新页面

==前言==
本页面简单介绍几个解析器函数语句的功能以及使用方法，其内容基本摘自mediawiki<ref>[https://www.mediawiki.org/wiki/Help:Extension:ParserFunctions 解析器函数]</ref>。解析器函数通常要基于'''[[帮助/模板|模板]]'''功能，因此建议在阅读本页之前先了解相关内容。

编者水平有限，以下内容仅可作粗略参考，有意者请阅览Mediawiki链接中的介绍。

===这玩意有什么用？===
解析器函数用于分析所输入的代码，并根据情况输出不同的结果。虽然解析器函数的功能繁多，但是本页面介绍的几个函数基本上可以理解为某种条件运算符。

以已经弃用的[[模板:装备属性/鱼雷]]为例：
<pre>
{| class="wikitable sortable"
|-
!图鉴 编号!!class="unsortable"|立绘!!class="unsortable"|名称!!鱼雷!!命中!!对潜!!class="unsortable"|备注!!开发时间
|-
{{装备属性/鱼雷|图鉴编号=87|名称=三联533毫米鱼雷|稀有度=1|鱼雷=+3|开发=00:05:00|备注=[[沃克兰]]、[[柯尼斯堡]]级自带}}
{{装备属性/鱼雷|图鉴编号=225|名称=72厘米三连装鱼雷|稀有度=6|鱼雷=+15|开发=|备注=战利品商店兑换获得}}
|}
</pre>
{| class="wikitable sortable"
|-
!图鉴 编号!!class="unsortable"|立绘!!class="unsortable"|名称!!鱼雷!!命中!!对潜!!class="unsortable"|备注!!开发时间
|-
{{装备属性/鱼雷|图鉴编号=87|名称=三联533毫米鱼雷|稀有度=1|鱼雷=+3|开发=00:05:00|备注=[[沃克兰]]、[[柯尼斯堡]]级自带}}
{{装备属性/鱼雷|图鉴编号=225|名称=72厘米三连装鱼雷|稀有度=6|鱼雷=+15|开发=|备注=战利品商店兑换获得}}
|}

可以看出，在调用这个模板时，需要输入鱼雷的一些信息和数据（鱼雷的名称、鱼雷值、图鉴编号等）才能完成这个列表。然而，装备名称的星级颜色并没有直接在输入的代码中出现；当开发时间为空时，对应的方框并不为空，而是写着“不可开发”。这就体现了解析器函数的作用：根据|稀有度所填入的数值自动转换“名称”文字的颜色，因此六星的鱼雷显示彩色名字，而一星的鱼雷显示黑色名字；当|开发=后面为空时，开发时间一项会自动填入“不可开发”。这种效果对应的解析器函数字符都会在下文提到。
==#if【非空/空】==
函数'''#if'''用于检测一段内容是否为空。如果不为空则输出结果一，为空则输出结果二。格式如下：
<pre>
{{#if:检测内容|不为空输出的结果|为空时输出的结果}}
</pre>
解析器函数都有类似的格式：用双大括号{{括起，接着写上井号#和函数对应的字符，后接半角冒号:，然后写入解析对象。函数有的函数在对象之后可以用竖线|分隔开来，竖线右侧部分用于自定义解析对象后输出的内容。

下面列出一些#if的使用效果：

*<code><nowiki>{{#if:|不为空|为空}}</nowiki></code>→{{#if:|不为空|为空}}
*<code><nowiki>{{#if:381|不为空|为空}}</nowiki></code>→{{#if:381|不为空|为空}}
*<code><nowiki>{{#if:||{{黑幕|这里什么都没有}}}}</nowiki></code>→{{#if:||{{黑幕|这里什么都没有}}}}
*<code><nowiki>{{#if:0v0||{{黑幕|这里什么都没有}}}}</nowiki></code>→{{#if:0v0||{{黑幕|这里什么都没有}}}}

==#expr与#ifexpr【表达式】【表达式是否成立】==
函数'''#expr'''用于逻辑运算，验证表达式是否成立；或者根据数学规则得出表达式的结果。大部分情况下#expr可以视作用于数学运算，输入正确的公式就能得出结果。
<pre>
{{#expr:数学/逻辑表达式}}
</pre>
下面的代码使用#expr解析了一个小学算术表达式：

<pre>{{#expr:233*801/(1206-1405}}</pre>
expr会得出它的运算结果为：{{#expr:233*801/(1206-1405)}}

如果表达式本身不成立或对象为空（tan90°属于无效），则#expr会输入数字“0”，如果成立则输出数字“1”。

*<code><nowiki>{{#expr:}}</nowiki></code>→{{#expr:}}
*<code><nowiki>{{#expr:tan90}}</nowiki></code>→{{#expr:tan90}}
*<code><nowiki>{{#expr:1/0}}</nowiki></code>→{{#expr:1/0}}
*<code><nowiki>{{#expr:asin2}}</nowiki></code>→{{#expr:asin2}}
*<code><nowiki>{{#expr:ln(e)=1}}</nowiki></code>→{{#expr:ln(e)=1}}
*<code><nowiki>{{#expr:381>460}}</nowiki></code>→{{#expr:381>460}}
*<code><nowiki>{{#expr:VV=381}}</nowiki></code>→{{#expr:VV=381}}

↑#expr只能识别数学内容及符号。

另一个字符'''#ifexpr'''同样用于验证表达式是否成立，但是可以指定输出的结果。具体规则如下：
<pre>
{{#ifexpr:表达式|成立/不为空时输出的结果|成立/不为空时输出的结果}}
</pre>

这里使用了与上面一样的表达式，但是输出的结果不同。代码和效果如下：

*<code><nowiki>{{#ifexpr:|结果不为空|结果为空}}</nowiki></code>→{{#ifexpr:|结果不为空|结果为空}}
*<code><nowiki>{{#ifexpr:tan90|结果不为空|结果为空}}</nowiki></code>→{{#ifexpr:tan90|结果不为空|结果为空}}
*<code><nowiki>{{#ifexpr:1/0|1|0}}</nowiki></code>→{{#ifexpr:1/0|1|0}}
*<code><nowiki>{{#ifexpr:asin2|1|0}}</nowiki></code>→{{#ifexpr:asin2|1|0}}
*<code><nowiki>{{#expr:ln(e)=1|正确|错误}}</nowiki></code>→{{#expr:ln(e)=1|正确|错误}}
*<code><nowiki>{{#ifexpr:381>460|381比较大|460比较大}}</nowiki></code>→{{#ifexpr:381>460|381比较大|460比较大}}
*<code><nowiki>{{#ifexpr:VV=381|VV是381|VV不是381}}</nowiki></code>→{{#ifexpr:VV=381|VV是381|VV不是381}}

↑可见#ifexpr同样只能识别数学内容及符号。

以下代码摘自[[模板:技能]]的部分内容，用于解释#expr与#ifexpr的运用。

{| class="wikitable"
|-
|
<nowiki>{{</nowiki>#vardefine:shipname|<nowiki>{{</nowiki>#invoke:舰娘|查找编号|<nowiki>{{{</nowiki>编号<nowiki>}}}</nowiki>}}}}
|这一句定义了动态变量“shipname”，内容为【参照<nowiki>{{{编号}}}</nowiki>去数据库里调用对应编号的舰娘名称】。
|-
|
<nowiki>{{</nowiki>#vardefine:linkname
|这一句准备定义变量“shiplink”，其定义见以下三行：
|-
|
|<nowiki>{{</nowiki>#ifexpr:<nowiki>{{{</nowiki>编号<nowiki>}}}</nowiki>>1000
|条件：如果表达式【<nowiki>{{{编号}}}</nowiki>大于1000】成立，则：（接下行）
|-
|
|<nowiki>{{</nowiki>#invoke:舰娘|查找编号|<nowiki>{{</nowiki>#expr:<nowiki>{{{编号}}}</nowiki>-1000<nowiki>}}}}</nowiki>
|【参照<nowiki>{{{编号}}}</nowiki>减去1000后的数字，去数据库里调用对应编号的舰娘名称】。
|-
|
|<nowiki>{{#var:shipname}}</nowiki>}}
|否则（即<nowiki>{{{编号}}}</nowiki>小于1000的情况下），【参照<nowiki>{{{编号}}}</nowiki>去数据库里调用对应编号的舰娘名称】。这种情况下“shipname”与“shiplink”是相同的。
|-
|colspan=2 style="text-align:center"|
注：在舰娘属性数据库中，编号1000以后的舰娘为改造后，编号1对应胡德未改，1001为胡德·改。这种情况下胡德·改的“shipname”还是'''胡德·改'''（no.1001），但是“shiplink”会是'''胡德'''（no.1）。
|-
|
<nowiki><nowiki>{{#var:shipname}}</nowiki>">[[File:Ship girl <nowiki>{{{编号}}}</nowiki>.png|链接=<nowiki>{{#var:linkname}}</nowiki>|80px]]
|这一部分对应下方表格中的“舰娘”一列（有Q版图的那一列）。以胡德·改为例，随着编辑者在技能模板中输入编号1001，上方的定义域会将胡德·改的“shipname”变量定义为胡德·改，“shiplink”变量定义为胡德。最终结果为，把鼠标放在舰娘这一格上会显示文字“胡德·改”，而点击Q版图片时的链接为胡德页面。
|-
|
<nowiki> </nowiki><nowiki>[[</nowiki><nowiki>{{#var:linkname}}</nowiki>{{!}}<nowiki>'''{{#var:shipname}}'''</nowiki><nowiki>]]</nowiki><nowiki></nowiki>
|原理同上，令Q版图片下方的文字写着胡德·改，链向胡德页面。
|}

下方表格所使用的技能模板代码只有如下一小段：
<pre>
{{技能|编号=1001|类型=BUFF|备注=|类型2=BUFF|备注2=皇家{{黑幕|赛艇}}飙车}}
{{技能|编号=331|类型=被动|备注=}}
</pre>
{| class="wikitable sortable responded skill" style="text-align:center;"
|-
! colspan="7" style="background:#CCCCFF" | 技能列表
|-
!width="30"| '''编号'''
!width="50"| '''舰娘'''
!width="70"| '''名称'''
!width="40"| '''改造'''
!width="40"| '''技能类型'''
!width="350"| '''技能效果''' Lv1/Lv2/Lv3
!width="350"| '''注释'''
{{技能|编号=1001|类型=BUFF|备注=|类型2=BUFF|备注2=皇家{{黑幕|赛艇}}飙车}}
{{技能|编号=331|类型=被动|备注=}}
|}

==#ifexist【目标是否存在】==
'''#ifexist'''用于检测'''本百科'''中的指定页面或者文件是否存在，并根据其存否而输出两种结果。

<pre>{{#ifexist:[[页面或文件]]|存在时输出的结果|不存在时输出的结果}}</pre>

下面举两个实际使用的栗子：
<pre><div style="text-align:right">
大和今天回家了吗？{{#ifexist:[[大和]]|她来啦！无糖灭世波！|没有ಥ_ಥ}}
</div></pre>

如果页面[[大和]]存在（就是说左边的链接不为红色），在“大和今天回家了吗？”之后会跟随{{注音|很丢人的文字|wtmsb}}；如果页面不存在则会跟随“没有ಥ_ಥ”。上方代码的具体效果见右侧：

<div style="text-align:right">大和今天回家了吗？{{#ifexist:[[大和]]|她来啦！无糖灭世波！|没有ಥ_ಥ}}</div>

第二个栗子：
<pre>你游{{#ifexist:文件:L BROKEN 666.png|怎么还没丸？|药丸！}}</pre>
这段代码会检测图片文件[[:文件:L BROKEN 666.png|文件:L BROKEN 666.png]]。根据本站的文件上传准则，这个名称的图片必须是编号为666的舰船的大破立绘。如果不存在此图片会输出结果“你游药丸！”，如果存在{{黑幕|这怎么可能？}}则会输出“你游怎么还没丸？”

代码的具体效果如下：

你游{{#ifexist:文件:L BROKEN 666.png|怎么还没丸？|药丸！}}
==#ifeq【两项是否相等】==
'''#ifeq'''用于比对两串字符，并且根据字符是否相等而输出两种结果。
<pre>
{{#ifeq:内容1|内容2|相等输出结果|不相等输出结果}}
</pre>
当两项内容皆为有效数值时，#ifeq会从数学上进行对比。

*<code><nowiki>{{#ifeq:1|01|相等|不相等}}</nowiki></code>→{{#ifeq:1|01|相等|不相等}}
*<code><nowiki>{{#ifeq:1|10|相等|不相等}}</nowiki></code>→{{#ifeq:1|10|相等|不相等}}
*<code><nowiki>{{#ifeq:10|2*3+4|相等|不相等}}</nowiki></code>→{{#ifeq:10|2*3+4|相等|不相等}}
*<code><nowiki>{{#ifeq:0|ln(1)|相等|不相等}}</nowiki></code>→{{#ifeq:0|ln(1)|相等|不相等}}
*<code><nowiki>{{#ifeq:2^16|65536|相等|不相等}}</nowiki></code>→{{#ifeq:2^16|65536|相等|不相等}}
*<code><nowiki>{{#ifeq:VV|381|相等|不相等}}</nowiki></code>→{{#ifeq:VV|381|相等|不相等}}

以下内容摘自[[模板:敌舰]]，用于展示#ifeq的使用案例。
<pre>
{{#ifeq: {{{星级|}}} | 1 | {{color|#A5A5A5|{{{战舰名|}}}}} |}}{{#ifeq: {{{星级|}}} | 2 | {{color|#00DB00|{{{战舰名|}}}}} |}}{{#ifeq: {{{星级|}}} | 3 | {{color|#00E3E3|{{{战舰名|}}}}} |}}{{#ifeq: {{{星级|}}} | 4 | {{color|#FF42FF|{{{战舰名|}}}}} |}}{{#ifeq: {{{星级|}}} | 5 | {{color|#FACC2E|{{{战舰名|}}}}} |}}{{#ifeq: {{{星级|}}} | 6 | {{color|#FF6262|{{{战舰名|}}}}}
</pre>

可见这段代码规定了，当敌舰模板中填入了“星级”这一项信息时，会影响同一模板中填入的“战舰名”文字的颜色。其逻辑如下：

<code><nowiki>{{#ifeq: {{{星级|}}} | 1 | {{color|#A5A5A5|{{{战舰名|}}}}} |}}</nowiki></code> 如果输入的“星级”为1，则调用[[模板:color|文字颜色模板]]将“战舰名”的颜色改为{{color|#A5A5A5|#A5A5A5}}。否则不输出内容，接下段：

<code><nowiki>{{#ifeq: {{{星级|}}} | 2 | {{color|#00DB00|{{{战舰名|}}}}} |}}</nowiki></code> 如果星级为2则使用颜色{{color|#00DB00|#00DB00}}，否则不输出内容，接下段↓

<code><nowiki>{{#ifeq: {{{星级|}}} | 3 | {{color|#00E3E3|{{{战舰名|}}}}} |}}</nowiki></code> 如果星级为2则使用颜色{{color|#00E3E3|#00E3E3}}，否则不输出内容，接下段↓

<code><nowiki>{{#ifeq: {{{星级|}}} | 4 | {{color|#FF42FF|{{{战舰名|}}}}} |}}</nowiki></code> 如果星级为2则使用颜色{{color|#FF42FF|#FF42FF}}，否则不输出内容，接下段↓

<code><nowiki>{{#ifeq: {{{星级|}}} | 5 | {{color|#FACC2E|{{{战舰名|}}}}} |}}</nowiki></code> 如果星级为2则使用颜色{{color|#FACC2E|#FACC2E}}，否则不输出内容，接下段↓

<code><nowiki>{{#ifeq: {{{星级|}}} | 6 | {{color|#FF6262|{{{战舰名|}}}}} |}}</nowiki></code> 如果星级为2则使用颜色{{color|#FF6262|#FF6262}}，否则不输出内容。

如果“星级”的范围不仅限于1~6，那么上方的代码可以继续拓展，直到穷尽“星级”可对应的所有数值。

==#switch【映射变换】==
#switch用于解析一串字符，并根据'''预设的字符-结果对应表'''来输出对应的结果。其代码形式如下：
<pre>
{{#switch:输入的内容
|内容1 = 结果1
|内容2 = 结果2
|内容3 = 结果3
|内容4
|内容5
|内容6 = 结果6
...
|内容n = 结果n
|默认结果
}}
</pre>
如果“输入的内容”等于“内容1”，则函数输出“结果1”；“输入的内容”等于“内容2”则输出“结果2”，以此类推。当某一项内容没有对应的结果（后面没有等于号“=”）时，会自动映射下方第一个结果，即“内容4”、“内容5”和“内容6”都会输出“结果6”。如果“输入的内容”不属于预设的【内容x=结果x】映射表中的任何一项，则输出“默认结果”。

以下代码摘自[[模板:装备图鉴表上]]，用于展示#switch的使用方法。

<pre>
{{ #switch: {{{星级1|}}}
| 1 = {{color|black|<big>'''{{{名称1|}}}'''</big>}}
| 2 = {{color|green|<big>'''{{{名称1|}}}'''</big>}}
| 3 = {{color|blue|<big>'''{{{名称1|}}}'''</big>}}
| 4 = {{color|purple|<big>'''{{{名称1|}}}'''</big>}}
| 5 = {{color|orange|<big>'''{{{名称1|}}}'''</big>}}
| 6 = {{color|rainbow|<big>'''{{{名称1|}}}'''</big>}}
}}
</pre>

这段代码的逻辑与上面引用自敌舰模板的代码是一样的：当“星级”等于1时，调用color模板使输出的“名称1”变为黑色；“星级”为2则对应绿色字，以此类推。实际上#switch也可以用于替换#ifeq。

==拓展阅读==
<references/>

[https://www.mediawiki.org/wiki/Extension:Variables 动态变量]

[https://www.mediawiki.org/wiki/Extension:Scribunto/Lua_reference_manual 维基框架下的Lua语言应用]

帮助:解析器函数 - 版本历史

Donnyjie：​Donnyjie移动页面帮助/解析器函数至帮助:解析器函数

雨音伴嵩：​新条目

Donnyjie：Donnyjie移动页面帮助/解析器函数至帮助:解析器函数

雨音伴嵩：新条目