Modul:Gapnum/doc

Acest modul este utilizat de {{val}}.

Utilizare în alte module

gaps

Funcția gaps poate fi utilă pentru formatarea în module care funcționează cu afișarea de numere mari.

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

În apelul funcției gaps, primul argument este numărul de formatat. Al doilea poate fi un tabel cu chei care spun modulului cum să formateze. Cheile ce se pot utiliza sunt:

• gap - număr asociat unei unități CSS (px, em, en etc.) care definește dimensiunea spațiului între numere. Dacă este lăsat gol, modulul va folosi 0.25em.
• prec - un număr ce determină precizia părții zecimale a numărului. Dacă precizia e mai mică decât numărul de cifre, cifrele suplimentare vor fi șterse fără rotunjire; dacă este mai mare, se vor adăuga zerouri la sfârșit pentru a obține precizia dorită. Dacă e lăsat gol, atunci modulul va folosi -1, ceea ce înseamnă că precizia va fi aceeași ca și numărul dat, fără adăugiri și eliminări de cifre.

Funcția întoarce un tabel, deci se pot adăuga stiluri și text în spanul conținător, dar aceasta înseamnă și că va fi nevoie să se apeleze tostring() din alte module.

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

Funcția groups se poate utiliza în alte module pentru a separa numărul în grupuri, la fel ca gaps, dar în loc de string formatat, funcția întoarce tabele ale căror elemente sunt grupurile.

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