Brontekst bekijken van Sjabloon:Convert/gaps

<!--
-=============================================================
- Template:Convert/gaps - Convert with gaps between digits
-=============================================================
--                                  (see NOTES at bottom)
-->{{#switch:{{{disp|b}}} <!--#1a-->
  | out|2|output only|#|number =
  | #default = <!--else-show-inputs--
=============================================== Show inputs
------------------------------------ show amount 1
-->{{gapnum|{{formatnum:{{{1|99,000,500.12345678}}}|R}}<!--
   -->}}<!--endgapnum
---------------------------------------------------- space
-->{{#ifexpr:{{formatnum:{{{1|9999}}}|R}} > 999|&#32;|&nbsp;}}<!--
--show-unit-->{{convert|{{{1|10}}}|{{{2|m}}}|abbr={{
  #switch: {{{abbr|off}}}<!--condense 7 values to off/on/comma-->
    | off|out|none|comma|mos = off
    | on|in = on
  }}<!--endswitch {abbr}--
  -->|lk={{{lk|off}}}|adj={{{sing|{{{adj|off}}}}}}<!--
  -->|disp=unit|r={{{sp|}}} }}<!--show unit
=============================================== Mid-text if any
  -->{{#ifeq: {{{adj|off}}}|mid|<!--
    -->{{#ifeq:{{padleft:|1|{{{10|}}}}}|-||&#32;}}<!--
    -->{{{10|zzz}}}<!--show mid-text
  -->}}<!--endifeq {adj}=mid
----------------------------------------------- Show separator
-->{{#switch:{{{disp|b}}} <!--#1b-->
  | b = &#32;(
  | sqbr = &#32;[
  | br = <br />
  | or = &#32;or&#32;
  | s|/ = &#32;/&#32;
  | comma = ,&#32;
  | semi|semicolon = &#59;&#32;
  | x = <b/>{{{10|}}}<b/>
  | #default = '''[[Template:Convert/gaps|Convert/gaps]] -<!--
  --> Invalid separator''' "disp={{{disp|xx}}}" - try: <!--
  --> disp=or, disp=comma, disp=semi, disp=sqbr, disp=out,<!--
  --> disp=br, disp=x or disp=b.&nbsp;
  }}<!--endswitch {disp} #1b -->
}}<!--endsw {disp} #1a
================================================= Show results
-->{{gapnum<!--format gaps in result
  -->|{{choptext<!--chop result at "[" for any "[[Category:...]]"
  -->|{{formatnum:{{convert
      |{{{1|99000500.12345678}}}<!--
    -->|{{{2|m}}}|{{{3|ft}}}<!--
    -->|{{{4|}}}|{{{5|}}}|{{{6|}}}<!--optional
    -->|disp=number<!--show result 4 & unit--
    -->}}|R}}<!--endconvert of amount
    -->|[}}<!--endchoptext of amount
-->|prec={{#ifeq:{{#expr: 0*{{{4|a}}} }}|0<!--if {4} numeric
     --then-->|{{{4|2}}}<!--precision as {4}--
     --else-->|<!--omit to use result's precision
   -->}}<!--endif {4} numeric
   -->{{#ifeq:{{#expr: 0*{{{6|a}}} }}|0<!--if {6} numeric
     --then-->|{{{6|2}}}<!--precision as {6}--
   -->}}<!--endif {4} numeric
   -->}}<!--endgapnum #2
--------------------------------------------------
-->{{#switch:{{{disp|b}}} <!-- #2 -->
  | number|#|output number only =
  | #default =
  &#32;<!--space
  -->{{convert|{{formatnum:{{{1|10,005.123}}}}}<!--endformatnum
    -->|{{{3|ft}}}<!--
    -->|disp=unit<!--show result unit--
    -->|lk={{
    #switch:{{{lk|off}}}<!--condense link-mode as: off/on-->
      | off|in = off
      | on|out = on
    }}<!--endsw{lk}--
    -->|abbr={{<!--use abbreviation-mode-->
    #switch:{{{abbr|on}}}<!--condense 7 values to off/on-->
      | on|out|mos = on
      | none = none
    }}<!--endsw{abbr}--
    -->|adj={{{sing|{{{adj|off}}}}}}<!--use adjective-mode
    -->|r={{{sp|}}} }}<!--endconvert of amount
-->}}<!--endsw {disp} #2
-------------------------------------------------- show end text
  -->{{#switch:{{{disp|b}}} <!-- #3 -->
   | b = )
   | sqbr = ]
   | x = <b/>{{{11|}}}<b/>
   | #default =
   }}<!--endsw {disp} #3
--><noinclude><!--
-------------------------------------------------- Doc text-->
{| width=585px style="background:transparent;"
| The converter [[Template:Convert/gaps]] will convert an amount and display gaps between digits. The gaps are not actual spaces, so copy/paste of numbers, as displayed, treats them as typical connected digits. To set the rounding precision, the output unit must be specified, or put "0" to default.
:'''Usage''': &nbsp; &nbsp; {&#123;convert/gaps |10000|m|ft}}
:::: {&#123;convert/gaps |123456|km|mi|abbr=on}}
:::: {&#123;convert/gaps |10.54001|L|usgal|3}}
The template has the same parameters as [[Template:Convert]], and so it allows abbreviation abbr=in, abbr=out, abbr=on or abbr=off, wikilinks lk=in or lk=out, and adjective mode adj=on or adj=mid. The separator can also be a semicolon: disp=semi, disp=semicolon, disp=or, disp=comma, disp=x (customized), disp=b (default as parentheses), disp=2 (or disp=out) and disp=# (or disp=number).

===Examples===
The examples show various options of conversions:
* {&#123;convert/gaps |9500|km|mi}}{{pad|2em}}&rarr; {{convert/gaps |9500|km|mi}}
* {&#123;convert/gaps |123456|km|mi|abbr=on}}{{pad|1em}}&rarr; {{convert/gaps |123456|km|mi|abbr=on}}
* {&#123;convert/gaps |9500.10055|km|mi|lk=out}} &rarr; {{convert/gaps |9500.10055|km|mi|lk=out}}
* {&#123;convert/gaps |9500.10055|km|mi|2}}{{pad|20px}}&rarr; {{convert/gaps |9500.10055|km|mi|2}}
* {&#123;convert/gaps |9500|km|mi|disp=sqbr}} &nbsp; &rarr; {{convert/gaps |9500|km|mi|disp=sqbr}}
* {&#123;convert/gaps |9500|km|mi|abbr=off}} &nbsp; &rarr; {{convert/gaps |9500|km|mi|abbr=off}}

Display types: disp=comma, disp=semi, disp=or, disp=output only, disp=output number only, disp=x and disp=b. The numeric results are identical to using Template:Convert for each amount individually.

===Common problems===
Note the name of this template is "convert/gaps" and omitting the suffix "/gaps" will not show gaps in digits.

The amount is followed by a unit-code (such as "|m") as the 2nd parameter. The output unit-code can be "0" as the 3rd parameter, to allow the default output unit to be triggered, while setting parameter 4 to a rounding precision (such as "|5").
|}<!--
--------------------------------------------------------------
--NOTES
--
-- NOTE A1: This template converts numbers and shows gaps
--      between digits, using {gapnum|...} to display numbers.
--      It is a wrapper for Template:Convert, which is used
--      3 times for each conversion, to set the input unit
--      name (or symbol), the output amount, and output unit.
--
-- NOTE S2: The value of any decimal portions are shifted,
--      slightly, when displayed, to correct for any potential
--      rounding errors when displaying the end-digits of
--      the decimal portion. The shift is only for display,
--      and the amounts being converted are not shifted. The
--      problem was {gapnum|9500.10055} showed 9500.10054.
--
--------------------------------------------------------------
--HISTORY:
--03Feb2011 Created, from Convert/4 to show gaps in digits.
--04Feb2011 Put NOTES comments to explain template operation.
--28Feb2011 Allowed disp=2 or disp=out to show output only.
--28Feb2011 Allowed disp=# or disp=number to show only number.
--11Oct2011 Fixed to default to precision of result, not of {1}
--11Oct2011 Fixed to allow precision in either {4} or {6}.
--11Oct2011 Renamed "br" as "disp=sqbr" square brackets "[]".
--11Oct2011 Changed "disp=br" to separate values by "<br />".
--11Oct2011 Updated error message to note disp=sqbr, disp=br.
--10Apr2013 Used {choptext} to remove any hidden "[[Category:..]]".
--
-->

[[Category:2011 Convert unit subtemplates]]
[[Category:Extended Convert subtemplates]]
</noinclude>