Module:For nowiki/sandbox

This is the module sandbox page for Module:For nowiki (diff).

Module documentation[view] [edit] [history] [purge]

This module is rated as ready for general use. It has reached a mature form and is thought to be relatively bug-free and ready for use wherever appropriate. It is ready to mention on help pages and other Wikipedia resources as an option for new users to learn. To reduce server load and bad output, it should be improved by sandbox testing rather than repeated trial-and-error editing.

This module is subject to page protection. It is a highly visible module in use by a very large number of pages, or is substituted very frequently. Because vandalism or mistakes would affect many pages, and even trivial editing might cause substantial load on the servers, it is protected from editing.

This Lua module is used on approximately 9,200 pages and changes may be widely noticed. Test changes in the module's /sandbox or /testcases subpages, or in your own module sandbox. Consider discussing changes on the talk page before implementing them.

This module implements a foreach loop that can be used from wikitext. It exports two functions:

main - Implements {{For nowiki}}, which can be used with explicitly provided parameters. Should not be called directly.
template - Designed to be used from within other templates. It takes explicit configuration parameters but it uses parameters passed to the parent frame (the template) for all others. Should be called directly.

Usage

{{#invoke:For nowiki|template|separator|<nowiki>wikitext</nowiki>|offset=offset}}

separator and wikitext function the same as described in Template:For nowiki/doc#Usage.
offset is the offset of the first argument to process. Defaults to 0, which means the |1= parameter passed to the template is the first parameter processed.

Example

If you have a template _TEMPLATE_:

{{#invoke:For nowiki|template|
|<nowiki>* {{{i}}} is {{{1}}}. Next is {{#expr:{{{i}}} + 1}}.</nowiki>}}

Then calling:

{{_TEMPLATE_|A|B|Foo|Orange}}

Would produce:

1 is A. Next is 2.
2 is B. Next is 3.
3 is Foo. Next is 4.
4 is Orange. Next is 5.

local p = {}

local function doLoop(frame, args, code, sep, offset, argstosub, iterfunc)
	local result = {}
	code = mw.text.unstripNoWiki(code)
	for i, value in iterfunc(args) do
		if i > offset then
			argstosub["1"] = value
			local actualCode = code
				:gsub("{{{i}}}", i - offset)
				:gsub("{{{([^{}|]*)|?[^{}]*}}}", argstosub)
			table.insert(result, frame:preprocess(actualCode))
		end
	end
	return table.concat(result, sep)
end

local function makePrefixedIpairs(prefix)
	if not prefix then return ipairs end
	local function iter(a, i)
        i = i + 1
		local v = a[prefix .. i]
		if v then
			return i, v
		end
	end
	return function()
    	return iter, a, 0
	end
end

function p.main(frame)
	local args = frame:getParent().args
	local sep = args[1]
	local code = args.code or args[2]
	local offset = args.code and 1 or 2
	local start = args.start or 1
	local argstosub = {}
	for key, value in pairs(args) do
		if not tonumber(key) and key ~= "i" and key ~= "count" then
			argstosub[key] = value
		end
	end
	local countArg = args.count and tonumber(args.count);
	if countArg then
		offset = 0
		args = {}
		for i = 1, countArg do
		   args[i] = i + start - 1
		end
	end
	return doLoop(frame, args, code, sep, offset, argstosub, ipairs)
end

function p.template(frame) 
	local sep = frame.args[1]
	local code = frame.args[2] or frame.args.code
	local offset = tonumber(frame.args.offset) or 0
	local prefix = frame.args.prefix
	local parentFrame = frame:getParent()
	return doLoop(parentFrame, parentFrame.args, code, sep, offset, parentFrame.args, makePrefixedIpairs(prefix))
end

return p

Usage

Example

See also