查看“Module:ProcessArgs/doc”的源代码

{{documentation header}}
<!-- 文档页面 -->
该模块将参数添加到一个表中以便模块使用。

== 用法 ==
该模块通常只能在其他模块中调用，否则会出错。

=== norm函数 ===
<syntaxhighlight lang="lua">
require('Module:ProcessArgs').norm(origArgs)
</syntaxhighlight>
* {{cd|origArgs}}：可选（表），用于指定{{cd|args}}表，默认值为父框架<ref group="注" name="frame">通常为{{tcd|#invoke:}}所在页面的框架。</ref>的{{cd|args}}表。值为其他类型（包括{{cd|nil}}）时取默认值。
该函数会将{{cd|origArgs}}表中所有值的多余空字符删去（若表中某个值全部由空字符组成，则将其设置为{{cd|nil}}），并返回修改后的表。

=== merge函数 ===
<syntaxhighlight lang="lua">
require('Module:ProcessArgs').merge(origArgs,parentArgs,norm)
</syntaxhighlight>
* {{cd|origArgs}}：可选（表），用于指定{{cd|args}}表，默认值为当前框架<ref group="注">通常为{{tcd|#invoke:}}创建的框架。</ref>的{{cd|args}}表。值为其他类型（包括{{cd|nil}}）时先用该值覆盖{{cd|norm}}的值，然后取默认值。
* {{cd|parentArgs}}：可选（表），用于指定{{cd|args}}表，当{{cd|origArgs}}不是表时默认值为父框架<ref group="注" name="frame" />的{{cd|args}}表。值为其他类型（包括{{cd|nil}}）时会出错。
* {{cd|norm}}：可选（布尔值），用于指定是否将表中全部由空字符组成的值设置为{{cd|nil}}。当{{cd|origArgs}}不是表时取{{cd|origArgs}}的值。
该函数会将{{cd|origArgs}}和{{cd|parentArgs}}这两个表合并（若两个表有相同的键，则优先取{{cd|parentArgs}}中的值），同时将表中所有值的多余空字符删去，并返回合并后的表。

<references group="注" />

== 示例 ==
假设{{Direct link|模块:Example}}包含以下代码：

<syntaxhighlight lang="lua">
local p = {}
function p.args(f)
	local arg1 = require('Module:ProcessArgs').norm()
	local arg2 = require('Module:ProcessArgs').norm(f.args)
	local arg3 = require('Module:ProcessArgs').merge(true)
	return mw.allToString(arg1[1],arg2[2],arg2['args'],arg3.name)
end
return p
</syntaxhighlight>

{{Direct link|Template:Example}}包含以下代码：

{{tcd|#invoke:Example|args|foo|&nbsp;&nbsp;bar&nbsp;&nbsp;|ba&nbsp;z|name{{=}}&nbsp;na&nbsp;&nbsp;me&nbsp;}}

页面{{Direct link|Example}}包含以下代码：

{{tcd|Example|&nbsp;&nbsp;a&nbsp;&nbsp;rg1&nbsp;&nbsp;&nbsp;&nbsp;|2{{=}}arg2|args{{=}}abc&nbsp;}}

那么页面{{Direct link|Example}}将会显示：

{{cd|a&nbsp;&nbsp;rg1	bar	nil	na&nbsp;me}}

<includeonly>
<!-- 模块分类和跨语言链接 -->
[[Category:元模块]]

[[en:Module:ProcessArgs]]
</includeonly>
<noinclude>
<!-- 文档分类和跨语言链接 -->
[[en:Module:ProcessArgs/doc]]
</noinclude>