Kitaen ti taudan para iti Modulo:Math/dok

{{Subpanid ti dokumentasion}}
{{adu a panagusar}}

Daytoy a modulo ket mangited kadagiti bilang ti annong ti matematika. Dagitoy nga annong ket mabalin nga usaren manipud iti #invoke wenno manipud kadagiti sabali a modulo ti Lua.

== Panagusar manipud kadagiti sabali a modulo ti Lua ==
Ti panagusar ti modulo manipud kadagiti normal a panid ti wiki, awan ti nangruna a nasken a maisagana. No usaren daytoy a modulo manipud iti sabali a modulo ti Lua, nasken nga umuna nga ikarga daytoy, kasla daytoy:

<syntaxhighlight lang="lua">
local mm = require('Modulo:Math')
</syntaxhighlight>

(Dagiti <code>mm</code> sabsabali a kita ket kaibuksilan ti '''M'''odulo '''M'''ath; mabalin pay ti agpili ti nasaysayaat a panangipalawag no kayat.)

Kaaduan kadagiti annong iti modulo ket addaan iti bersion para iti Lua ken bersion ara iti #invoke. Mabalin nga usaren dagiti annong ti #invoke manipud kadagiti sabali a modulo ti Lua, ngem ti panagusar kadagiti annong ti Lua ket nasaysayaat gapu ta saan a nasken a serrekan ti Lua [[mw:Extension:Scribunto/Lua reference manual#Frame object|kuadro ti banag]]. Dagiti annong ti Lua ket pasarunuan babaen ti <code>_</code>, bayat a saan a mapasarunuan dagiti annong ti #invoke.

== random ==
{{kitaen pay ti|Modulo:Pugto}}

 &#123;{#invoke:math|random}}
 &#123;{#invoke:math|random|''max_value''}}
 &#123;{#invoke:math|random|''min_value''|''max_value''}}

<syntaxhighlight lang="lua">
mm._random()
mm._random(max_value)
mm._random(min_value, max_value)
</syntaxhighlight>

Agpataud iti pugto a bilang.

* No awan dagiti argumento a mainaganan, ti bilang a mapataud ket dakdakkel ngem wenno kapada ti 0 ken basbassit ngem 1.
* No awan ti argumento a maited, ti bilang a mapataud ket maysa a sibubukel a bilang a baetan ti 1 ken dayta nga argumento. Ti argumento ket nasken a positibo a sibubukel a bilang.
* No dua dagiti argumento ti maited, ti bilang a mapataud ket maysa a sibubukel a bilang a baetan ti immuna ken dagiti maikadua nga argumento. Isuda a dua dagiti argumento ket nasken a dagiti sibubukel a bilang, ngem mabalin met a negatibo.

Daytoy nga annong ket saan a husto nga agbalin para kadagiti bilang a basbassit ngem −2<sup>32</sup> ken dakdakkel ngem 2<sup>32</sup> − 1. No kayat nga agusar kadagiti bilang ti ruar iti daytoy a sakop, maisingasing nga usaren ti [[Modulo:Pugto]].

== order ==

 &#123;{#invoke:math|order|''n''}}

<syntaxhighlight lang="lua">
mm._order(n)
</syntaxhighlight>

Mangikeddeng ti urnos ti magnitud ti bilang.

== precision ==

 &#123;{#invoke:math|precision|''n''}}
 &#123;{#invoke:math|precision|x=''n''}}

<syntaxhighlight lang="lua">
mm._precision(number_string)
</syntaxhighlight>

Mangikeddeng ti presision ti bilang. Kas pagarigan, para iti "4" daytoy ket mangisubli ti "0", para iti "4.567" daytoy ket mangisubli ti"3", ken para iti "100" daytoy ket mangisubli ti "-2".

Ti annong ket mangpadas a mangwaswas ti representasion ti kuerdas ti bilang, ken mangduktal no ti bilang ket agus-usar ti [[Sientipiko a notasion#Notasion ti E|notasion ti E]]. Gapu ti daytoy a rason, no maawagan manipud iti Lua, dagiti dakkel unay a bilbilang wenno husto unay a bilbilang ket nasken a dagus a maikabil a kas dagiti kuerdas tapno makaala kadagiti agpayso a resulta. No maikabil dagitoy a kas dagiti bilang, ti panangiyulog iti Lua ket baliwanna idi iti notasion ti E ken daytoy nga annong ket mangisubli ti presision ti notasion ti E imbes a ti kasisigud a bilang. Daytoy ket saan a problema no ti bilang ket matawagan manipud iti #invoke, gapu ta ti amin a maikanbil manipud iti #invoke ket adda iti pormat ti kuerdas.

== max ==

 &#123;{#invoke:math|max|''v1''|''v2''|''v3''|...}}

<syntaxhighlight lang="lua">
mm._max(v1, v2, v3, ...)
</syntaxhighlight>

Mangisubli iti kangatuan a pateg manipud kadagiti pateg a nainaganan. Dagiti pateg ket saan a mabaliwan kadagiti bilang saanto a maikaskaso.

== min ==

 &#123;{#invoke:math|min|''v1''|''v2''|''v3''|...}}

<syntaxhighlight lang="lua">
mm._min(v1, v2, v3, ...)
</syntaxhighlight>

Mangisubli iti kabassitan a pateg manipud kadagiti pateg a nainaganan. Dagiti pateg ket saan a mabaliwan kadagiti bilang saanto a maikaskaso.

== average ==

 &#123;{#invoke:math|average|''v1''|''v2''|''v3''|...}}

<syntaxhighlight lang="lua">
mm._average(v1, v2, v3, ...)
</syntaxhighlight>

Mangisubli iti natibeng kadagiti pateg a nainaganan. Dagiti pateg ket saan a mabaliwan kadagiti bilang saanto a maikaskaso.

== round ==

 &#123;{#invoke:math|round|''value''|''precision''}}
 &#123;{#invoke:math|round|value=''value''|precision=''precision''}}

<syntaxhighlight lang="lua">
mm._round(value, precision)
</syntaxhighlight>

Buklenna ti bilang iti naibaga a presision.

== log10 ==

 &#123;{#invoke:math | log10 | ''x''}}

<syntaxhighlight lang="lua">
mm._log10(x)
</syntaxhighlight>

Mangisubli iti <code>log<sub>10</sub>(''x'')</code>, ti logaritmo ti ''x'' nga agusar iti batayan a 10.

== mod ==

 &#123;{#invoke:math|round|''x''|''y''}}

<syntaxhighlight lang="lua">
mm._round(x, y)
</syntaxhighlight>

Mangala ti <code>''x''</code> modulo <code>''y''</code>, wenno ti nabati kalpasan no <code>''x''</code> ket nabingbingayen babaen ti <code>''y''</code>. Daytoy ket agpayso para kadagiti sibubukel a bilang aginggana iti 2<sup>53</sup>; para kadagiti daddadakkel a sibubukel a bilang, ti mangipataray a modulo ti Lua ket mabalin a mangisubli ti biddut a pateg. Daytoy nga annong ket mangigapu ti daytoy a problema babaen ti panangisubli ti <code>0</code> no timodulo a naited babaen ti panagpatary ti modulo ti Lua ket basbassit ngem 0 wenno dakdakkel ngem ti <code>''y''</code>.

== gcd ==

 &#123;{#invoke:math|gcd|''v1''|''v2''|...}}

<syntaxhighlight lang="lua">
mm._gcd(v1, v2, ...)
</syntaxhighlight>

Birukenna ti kadakkelan a sapasap a mangbingay kadagti pateg a nainaganan. Dagiti pateg ket saan a mabaliwan kadagiti bilang saanto a maikaskaso.

== precision_format ==

 &#123;{#invoke:math|precision_format|''value_string''|''precision''}}

<syntaxhighlight lang="lua">
mm._precision_format(value_string, precision)
</syntaxhighlight>

Buklenna ti bilang iti nainaganan a presision ken pormatenna segun kadagiti alagaden a kasisigud a naus-usar para iti {{tl|Rnd}}.  Ti maiparuar ket kuerdas.

== cleanNumber ==

<syntaxhighlight lang="lua">
local number, number_string = mm._cleanNumber(number_string)
</syntaxhighlight>

Ti katulong nga annong a mabalin a matawagan manipud kadagiti modulo ti Lua, ngem saan a mabalin manipud iti #invoke. Daytoy ket mangala ti kuerdas wenno pateg ti bilang a kas ti maikabil, ken no ti pateg ket mabalin a mabaliwan iti bilang, ti cleanNumber ket mangisubli ti bilang ken kuerdas ti bilang. No ti pateg ket saan a mabaliwan iti bilang, ti cleanNumber ket mangisubli ti <code>nil, nil</code>.

<includeonly>{{#ifeq:{{SUBPAGENAME}}|pagipadasan||
<!-- Ikabil dagiti kategoria dita baba ken dagiti interwiki idiay Wikidata -->
[[Kategoria:Dagiti modulo ti Wikipedia]]
}}</includeonly>