模組:Loop

模块文档[查看] [编辑] [历史] [清除缓存]

給wikitext使用的簡易迴圈，目前只有遞增型和遞減型兩種

使用方法

{{#invoke:Loop|increment|...arguments...}}

{{#invoke:Loop|decrement|...arguments...}}

• start：開始循環的數字。
• end：結束循環的數字。
• range：每次循環增加或減去的數字。
• content：循環的內容。
• delnowiki、delmsgnw：如其名。
• usingConditionalExpressions：去除循環內的跳脫字元，參見Module:TemplateParameters#FormatingArguments。

範例：

{{#invoke:Loop|increment
|start=1|end=10|range=1|delnowiki=1
|content=<nowiki>* 第{{{1}}}次，你好！</nowiki>
}}

或

{{#invoke:Loop|increment
|start=1|end=10|range=1|usingConditionalExpressions=1
|content=* 第\{\{\{1\}\}\}次，你好！\n
}}

結果：

• 第1次，你好！
• 第2次，你好！
• 第3次，你好！
• 第4次，你好！
• 第5次，你好！
• 第6次，你好！
• 第7次，你好！
• 第8次，你好！
• 第9次，你好！
• 第10次，你好！

其他可用在content的變數：

• {{{last}}}：上一個數字，若不存在則為空值。
• {{{current}}}：等同{{{1}}}。
• {{{next}}}：下一個數字，若不存在則為空值。

理論上也可以傳入浮點數，但如果出現了奇怪的行為的話建議使用整數。

上述文档嵌入自Module:Loop/doc。 (编辑 | 历史)
编者可以在本模块的沙盒 (创建 | 镜像)和测试样例 (创建)页面进行实验。
本模块的子页面。

local p = {}
local mYesno
local mTemplateParameters

local function yesno(value)
	if not mYesno then
		mYesno = require('Module:Yesno')
	end
	return mYesno(value)
end
	
local function loop(default_loopRange, validate_condition, stop_condition)
	return function (frame)	
		local args = frame.args
		local loopStart = tonumber(args['start'])
		local loopEnd = tonumber(args['end'])
		local loopContent = args.content
		if loopStart == loopEnd or not loopContent then
			return ''
		end
		local loopRange = tonumber(args['range']) or default_loopRange
		validate_condition(loopStart, loopEnd, loopRange)
		if yesno(args.delnowiki) then
			loopContent = mw.text.unstripNoWiki(loopContent)
		end
		if yesno(args.delmsgnw) then
			loopContent = mw.text.decode(loopContent)
		end
		if yesno(args.usingConditionalExpressions) then
			if not mTemplateParameters then
				mTemplateParameters = require('Module:TemplateParameters')
			end
			loopContent = mTemplateParameters._get_escape(loopContent)
		end
		local i = loopStart
		local output = ''
		local check_stop = stop_condition(loopStart, loopEnd, loopRange)
		while true do
			output = output .. loopContent:gsub('{{{1}}}', tostring(i))
			i = i + loopRange
			if check_stop(i) then
				break
			end
		end
		return mw.getCurrentFrame():preprocess(output)
	end
end

local _increment = loop(
	-- default_loopRange
	1,
	-- validate_condition
	function (loopStart, loopEnd, loopRange)
		if loopStart > loopEnd or loopRange < 0 then
			error('Only increment syntax allowed.')
		end
	end,
	-- stop_condition
	function (loopStart, loopEnd, loopRange)
		return function (i)
			return i > loopEnd
		end
	end
)

function p.increment(frame)
	return _increment(frame)
end

local _decrement = loop(
	-- default_loopRange
	-1,
	-- validate_condition
	function (loopStart, loopEnd, loopRange)
		if loopStart < loopEnd or loopRange > 0 then
			error('Only decrement syntax allowed.')
		end
	end,
	-- stop_condition
	function (loopStart, loopEnd, loopRange)
		return function (i)
			return i < loopEnd
		end
	end
)

function p.decrement(frame)
	return _decrement(frame)
end

return p