Mòdul:Gapnum/ús

utilitza aquest mòdul.

Ús en altres mòduls

gaps

La funció gaps pot ser útil per formatar en altres mòduls que treballen en la visualització de números grans.

local gaps = require('Module:Gapnum').gaps

Mitjançant la funció de gaps, el primer argument és el número a formatar. El segon argument pot ser una taula amb claus que indiquen al mòdul com formatar. Les tecles de taula que es poden utilitzar són:

• gap - un número amb unitats CSS (px, em, en, etc.) que defineixen la mida del gap entre nombres. Si està en blanc, el mòdul utilitzarà 0.25em.
• prec - un número que determina la precisió de la part decimal del número. Si la precisió és inferior al númerode dígits, se suprimiran els dígits addicionals sense arrodonir; si és més, s'afegiran zeros al final per crear la precisió desitjada. Si està en blanc, el mòdul utilitzarà -1, la qual cosa significa que la precisió serà la mateixa que el número indicat; sense haver afegit ni eliminat dígits.

Tingueu en compte que la sentència retorna una taula. Això vol dir que es pot afegir més estil o text a l'etiqueta d'extensió de l'embolcall, però també pot significar que es pot requerir tostring() quan s'utilitza en altres mòduls.

local gaps = require('Module:Gapnum').gaps

function example()
	local n = 123456.78900011
	-- Example for just simple formatting of a number
	-- n_gaps will use the default, .25em gaps and no change in precision
	-- The result will have its gaps created with inline css
	-- But the result would look like:
	-- 123 456.789 000 11
	local n_gaps = gaps(n)

	-- Different gap size
	-- These will format n into the same groups as above
	-- But the spaces between the groups will be larger and smaller, respectively
	local n_big_gaps = gaps(n, {gap='1em'})
	local n_small_gaps = gaps(n, {gap='1px'})

	-- Different precision
	-- n_prec_5 will use the number 123456.78900
	-- The result would look like:
	-- 123 456.789 00
	local n_prec_5 = gaps(n, {prec=5})
	-- n_prec_10 will use the number 123456.7890001100
	-- The result would look like:
	-- 123 456.789 000 1100
	local n_prec_10 = gaps(n, {prec=10})

	-- Both different gaps and precision can be used:
	local n_big_5 = gaps(n, {gap='1em', prec=5})
	local n_small_10 = gaps(n, {gap='1px', prec=10})
end

groups

La funció groups es pot utilitzar en altres mòduls per separar un número en grups tal com ho fa gaps, però en lloc d'una cadena formatada, la funció retornarà taules els elements dels quals són els grups separats.

local groups = require('Module:Gapnum').groups

function example()
	-- This will return one table:
	-- {123,456}
	local n1 = groups(123456)

	-- This will return two tables, each assigned to a different variable:
	-- n2a will be:
	-- {1,234}
	-- n2b will be:
	-- {567,89}
	local n2a,n2b = groups(1234.56789)

	-- This will return two tables:
	-- An integer part is always returned, even if it is 0
	-- n3a will be:
	-- {0}
	-- n3b will be:
	-- {123,4567}
	local n3a,n3b = groups(0.1234567)

	-- Just like the other functions, a precision can be defined
	-- precision is simply the second parameter
	-- n4a will be:
	-- {123}
	-- n4b will be:
	-- {456,700,00}
	local n4a,n4b = groups(123.4567,8)
end