Modulo:Gapnum/man

Questo modulo è usato dal template {{val}}.

Uso in altri moduli

gaps

La funzione gaps può essere utilizzata per formattare numeri in altri moduli.

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

Per usare gaps il primo argomento è un numero da formattare, il secondo una tabella con le opzioni di formattazione. Le opzioni possibili sono:

• gap - una grandezza in unità CSS (px, em, en, etc) che definisce l'ampiezza dell'intervallo tra i numeri. Se nullo il modulo userà 0.25em.
• prec - un numero che determina la precisione della parte decimale del numero. Se la precisione è minore del numero di cifre decimali quelli in eccesso saranno rimossi senza arrotondare; se sono di più saranno aggiunti zeri al termine fino a raggiungere la precisione desiderata. Se nullo il modulo userà una precisione di -1, che significa il numero di cifre decimali rimarrà invariato, senza aggiungere o eliminare cifre;

La funzione ritorna una tabella, quindi il programma chiamate può applicare ulteriori stili, ma dovrà provvedere a concatenare il valore della tabella.

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 funzione groups può essere usata in altri moduli per separare un numero in gruppi nello stesso modo di gaps, ma invece di una stringa formattata string, la funzione ritornerà una tabella i cui elementi sono i gruppi di numeri.

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