Template:Round/doc: Difference between revisions
meta>Pinky sl sl:Predloga:Rnd |
meta>Wikid77 rewrote intro to show usage parameters & clarify options; expanded "Internal details" to compare the markup-based & Lua-based versions |
||
Line 2: | Line 2: | ||
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE. --> | <!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE. --> | ||
==Usage== | ==Usage== | ||
This template rounds | This template rounds parameter 1 by parameter 2 decimal places (goes the other way for negative rounding) and includes trailing zeros. | ||
::: {{<code>'''rnd'''|54.376|2</code>}} gives {{rnd|54.376|2}} | |||
::: {{<code>'''rnd'''|54.376|-1</code>}} gives {{rnd|54.376|-1}} | |||
::: {{<code>'''rnd'''|68.4273E12|-10</code>}} gives {{rnd|68.4273E12|-10}} | |||
For example, rounding by 1 gives 1 decimal digit, rounding by 0 gives integers, or rounding by -2 gives the amount in hundreds. [[Scientific notation]] is displayed for numbers greater than or equal to 1{{e|9}}, or less than 1{{e|−4}}. | |||
'''Examples:''' | |||
*{{<code>rnd|2.0004|3</code>}} gives {{rnd|2.0004|3}} | *{{<code>rnd|2.0004|3</code>}} gives {{rnd|2.0004|3}} | ||
**whereas {{<code>#expr:2.0004 round 3</code>}} gives {{#expr:2.0004 round 3}} | **whereas {{<code>#expr:2.0004 round 3</code>}} gives {{#expr:2.0004 round 3}} | ||
Line 27: | Line 31: | ||
==Internal details== | ==Internal details== | ||
The | The markup-based version of Template:rnd uses three subtemplates: | ||
*{{tl|rnd/-}} — for trailing zeros | *{{tl|rnd/-}} — for trailing zeros | ||
*{{tl|rnd/e+}} — for scientific notation for numbers greater than or equal to 10<sup>9</sup> or less than or equal to −10<sup>9</sup> | *{{tl|rnd/e+}} — for scientific notation for numbers greater than or equal to 10<sup>9</sup> or less than or equal to −10<sup>9</sup> | ||
*{{tl|rnd/e−}} — for scientific notation for numbers greater than −10<sup>−4</sup> and less than 10<sup>−4</sup> but not equal to zero | *{{tl|rnd/e−}} — for scientific notation for numbers greater than −10<sup>−4</sup> and less than 10<sup>−4</sup> but not equal to zero | ||
The [[Lua script|Lua]]-based version of <nowiki>{{rnd}</nowiki> uses [[Module:Math]] and always has an expansion depth of 3. However, the markup-based version has an expansion depth of 9–15, which depends on the size of the numbers (integer results use depth 9, decimals use depth 12), where astronomical numbers can hit expansion depth of 15 levels, for <nowiki>{{rnd|56.44e33|-32}}</nowiki> → 5.64 × 10<sup>34</sup>. | |||
==See also== | ==See also== |
Revision as of 15:10, 23 February 2013
This is a documentation subpage for Template:Round. It may contain usage information, categories and other content that is not part of the original template page. |
Usage
This template rounds parameter 1 by parameter 2 decimal places (goes the other way for negative rounding) and includes trailing zeros.
- {{
rnd|54.376|2
}} gives Template:Rnd - {{
rnd|54.376|-1
}} gives Template:Rnd - {{
rnd|68.4273E12|-10
}} gives Template:Rnd
- {{
For example, rounding by 1 gives 1 decimal digit, rounding by 0 gives integers, or rounding by -2 gives the amount in hundreds. Scientific notation is displayed for numbers greater than or equal to 1×109, or less than 1×10−4.
Examples:
- {{
rnd|2.0004|3
}} gives Template:Rnd- whereas {{
#expr:2.0004 round 3
}} gives 2
- whereas {{
- {{
rnd|0.000020004|7
}} gives Template:Rnd - {{
rnd|0|8
}} gives Template:Rnd - {{
rnd|154268|-3
}} gives Template:Rnd {{rnd|1200004|-1}}
→ Template:Rnd- whereas
{{#expr:1200004round-1}}
→ 1200000, even though{{#expr:1300004round-1}}
→ 1300000 (see m:Help:Format produced by expr)
- whereas
{{rnd|1300004|-1}}
→ Template:Rnd{{rnd|4.1e6|9}}
→ Template:Rnd{{rnd|4.1e6|10}}
→ Template:Rnd{{rnd|1542689271|-7}}
→ Template:Rnd{{rnd|1542689271|2}}
→ Template:Rnd{{rnd|7e9|-9}}
→ Template:Rnd{{rnd|-123|1}}
→ Template:Rnd{{rnd|-1200007|-2}}
→ Template:Rnd{{rnd|-1234567899|-7}}
→ Template:Rnd
As with #expr, the total number of significant digits is not more than 14:
{{rnd|1234567890.123456789|10}}
→ Template:Rnd{{rnd|123456789.0123456789|10}}
→ Template:Rnd{{rnd|.0001234567890123456789|20}}
→ Template:Rnd
Internal details
The markup-based version of Template:rnd uses three subtemplates:
- {{rnd/-}} — for trailing zeros
- {{rnd/e+}} — for scientific notation for numbers greater than or equal to 109 or less than or equal to −109
- {{rnd/e−}} — for scientific notation for numbers greater than −10−4 and less than 10−4 but not equal to zero
The Lua-based version of {{rnd} uses Module:Math and always has an expansion depth of 3. However, the markup-based version has an expansion depth of 9–15, which depends on the size of the numbers (integer results use depth 9, decimals use depth 12), where astronomical numbers can hit expansion depth of 15 levels, for {{rnd|56.44e33|-32}} → 5.64 × 1034.
See also