Module:BaseConvert/doc: Difference between revisions
Appearance
From Wikipedia, the free encyclopedia
Undid revision 545130004 by Tbhotch (talk) rv: unnecessary - {{documentation}} handles any lock icons that may be needed
Document new syntax
Line 1:
Line 1:
Converts numbers to a specified base between 2 and 36, for use in templates such as {{tl|binary}}, {{tl|octal}}, {{tl|hexadecimal}}, etc.
Converts numbers to a specified base between 2 and 36, for use in templates such as {{tl|binary}}, {{tl|octal}}, {{tl|hexadecimal}}, etc.
==Usage==
Example usage:
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
local BaseConvert = require('Module:BaseConvert')
local BaseConvert = require('Module:BaseConvert')
Line 15:
Line 15:
*'''default''' - Value to return if n is empty or non-numeric. Defaults to the value of n.
*'''default''' - Value to return if n is empty or non-numeric. Defaults to the value of n.
*'''prefix''' / '''suffix''' - wikitext to add before/after the returned result. Will not be added if n is empty or non-numeric. For example, you might use a prefix of <code>0x</code> when converting to hex, or a suffix of <code><nowiki><sub>8</sub></nowiki></code> when converting to octal.
*'''prefix''' / '''suffix''' - wikitext to add before/after the returned result. Will not be added if n is empty or non-numeric. For example, you might use a prefix of <code>0x</code> when converting to hex, or a suffix of <code><nowiki><sub>8</sub></nowiki></code> when converting to octal.
===From templates===
In wikimarkup, this module may be called with a function name <code>''n''to''m''</code>, e.g.:
{{Markup
|<nowiki>{{#invoke:BaseConvert/sandbox|16to10| FF }}</nowiki>|{{#invoke:BaseConvert/sandbox|16to10| FF }}
|<nowiki>{{#invoke:BaseConvert/sandbox|10to36|500}}</nowiki>|{{#invoke:BaseConvert/sandbox|10to36|500}}
|<nowiki>{{#invoke:BaseConvert/sandbox|10to16|Foo|default=0}}</nowiki>|{{#invoke:BaseConvert/sandbox|10to16|Foo|default=0}}}}
All options above are supported, excluding {{para|base}}, {{para|from}} and {{para|n}} which are set by the mandatory options. You may also call <code>_convert</code> which is near-identical to the Lua form above.
Revision as of 20:33, 27 April 2021
Converts numbers to a specified base between 2 and 36, for use in templates such as {{binary }}, {{octal }}, {{hexadecimal }}, etc.
Usage
localBaseConvert=require('Module:BaseConvert') BaseConvert.convert({n=14600926,base=16})-- returns 'DECADE'
Arguments:
- n - (required) the number to be converted, as a string. It may be a number instead, if the input base is 10.
- base - (required) the base to which the number should be converted. May be between 2 and 36, inclusive.
- from - the base of the input. Defaults to 10 (or 16 if the input has a leading '0x'). Note that bases other than 10 are not supported if the input has a fractional part.
- precision - number of digits to be rendered after the radix point. Trailing zeros will be added if needed. If not specified, however many digits are needed will be shown, up to 10.
- width - minimum number of digits to be rendered before the radix point. Leading zeros will be added if needed.
- default - Value to return if n is empty or non-numeric. Defaults to the value of n.
- prefix / suffix - wikitext to add before/after the returned result. Will not be added if n is empty or non-numeric. For example, you might use a prefix of
0xwhen converting to hex, or a suffix of<sub>8</sub>when converting to octal.
From templates
In wikimarkup, this module may be called with a function name ntom, e.g.:
| Markup | Renders as |
|---|---|
{{#invoke:BaseConvert/sandbox|16to10| FF }} |
255 |
{{#invoke:BaseConvert/sandbox|10to36|500}} |
DW |
{{#invoke:BaseConvert/sandbox|10to16|Foo|default=0}} |
0 |
All options above are supported, excluding |base=, |from= and |n= which are set by the mandatory options. You may also call _convert which is near-identical to the Lua form above.