Módulo:Testes/Gkiyoshinishimoto/Separated entries

Documentação do módulo[ver] [editar] [histórico] [purgar]

Uso

Módulo:Testes/Gkiyoshinishimoto/Separated entries serve como predefinição front-end para mw.text.listToText. Ele pega qualquer número [en] de parâmetros posicionais e reúne-os com |separator=. O |conjunction= pode ser definido opcionalmente se um separador diferente for desejado entre o último e o penúltimo itens. O parâmetro posicional inicial pode ser especificado usando |start=. Os espaços em branco iniciais e finais são removidos. Para adicionar espaços em branco iniciais e finais deliberados, use o código de escape de linguagem de marcação de hipertexto (L.M.Ht.)   para um espaço e 
 para uma "nova linha". Entradas separadas não geram nenhum erro por design.

{{#invoke:Testes/Gkiyoshinishimoto|main|separator=...}}

Ver também

• {{Teste/Gkiyoshinishimoto/Enum}}
• {{#invoke:Teste/Gkiyoshinishimoto/Params|função}}

Nota

-- Este módulo recebe parâmetros posicionais como entrada e os concatena com
-- um separador opcional. O separador final (a "conjunção") pode ser
-- especificado de forma independente, permitindo listas de linguagem natural como
-- "foo, bar, baz e qux". O parâmetro inicial também pode ser especificado.

local compressSparseArray = require('Módulo:Testes/Gkiyoshinishimoto/TableTools').compressSparseArray
local p = {}

function p._main(args)
	local separator = args.separator
		-- Decodifica (converte para Unicode) sequências de escape de linguagem de marcação de hipertexto (L.M.Ht., ''Ht.M.L.''), como " " para espaço.
		and mw.text.decode(args.separator) or ''
	local conjunction = args.conjunction and mw.text.decode(args.conjunction) or separator
	-- Descarta valores antes do parâmetro inicial.
	local start = tonumber(args.start)
	if start then
		for i = 1, start - 1 do args[i] = nil end
	end
	-- Descarta parâmetros nomeados.
	local values = compressSparseArray(args)
	return mw.text.listToText(values, separator, conjunction)
end

local function makeInvokeFunction(separator, conjunction, first)
	return function (frame)
		local args = require('Módulo:Testes/Gkiyoshinishimoto/Arguments').getArgs(frame)
		args.separator = separator or args.separator
		args.conjunction = conjunction or args.conjunction
		args.first = first or args.first
		return p._main(args)
	end
end

p.main = makeInvokeFunction()
p.br = makeInvokeFunction('<br />')
p.comma = makeInvokeFunction(mw.message.new('comma-separator'):plain())

return p