साँचा:Val/विव का स्रोत देखें

<noinclude>{{documentation subpage}}</noinclude>
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->

==Purpose==
This template is used to easily present values in [[w:scientific notation|scientific notation]], including uncertainty and/or units. It wraps the entire result in a {{tl|nowrap}} block, so that it never gets broken into separate pieces at the end of a line. 

== Arguments ==
There are four ways this template can be used:
* <code><nowiki>{{</nowiki>val|''number''<nowiki>}}</nowiki></code> - for displaying values without uncertainty/significance.
* <code><nowiki>{{</nowiki>val|''number''|''uncertainty''<nowiki>}}</nowiki></code> - for displaying values with uncertainty like so {{val|1234|56}}.
* <code><nowiki>{{</nowiki>val|''number''|''upper uncertainty''|''lower uncertainty''<nowiki>}}</nowiki></code> - for displaying values with uncertainty like so {{val|1234|+56|-78}}.
* <code><nowiki>{{</nowiki>val|''number''|(''significance'')<nowiki>}}</nowiki></code> - for displaying values with significance like so {{val|1234|(56)}}.
They all take roughly the same arguments:
{|
|style="vertical-align:top;"| '''1'''  || The value (must be a valid number)
|-
|style="vertical-align:top;"| '''2'''  || The (upper limit of) uncertainty (must be a valid number) or significance (must be a valid number in parenthesis)
|-
|style="vertical-align:top;"| '''3'''  || The lower limit of uncertainty (must be a valid negative number)
|-
|style="vertical-align:top;"| '''e'''  || The exponent for the power of 10 (optional). This will show up in the result as "&nbsp;×&nbsp;10{{su|p=e}}".
|-
|style="vertical-align:top;"| '''u''' / '''ul'''   || The units for the number (optional, with/without a link to the page about the unit respectively).
|-
|style="vertical-align:top;"| '''up''' / '''upl''' || The units per for the units (optional, requires '''u''' to be specified, with/without a link to the page about the unit respectively).
:Units (specified by '''u''', '''ul''', '''up''' and '''upl''') are replaced by a more aesthetically pleasing HTML representation and get a link ('''ul''' and '''upl''' only, if they are in the list found in {{tl|val/units}} or if they are supported by {{tl|convert}}). You can specify units using just '''u'''; a good example is "ul=m/s", which gets translated to "[[w:Metre per second|m·s<sup>-1</sup>]]", or you can use '''u''' and '''up''', as in "u/up"; a good examples if "ul=m|up=s", which gets translated to "[[w:Metre|m]]/s".
|-
|style="vertical-align:top;"| '''p'''  || A prefix for the value (such as ∆, ⌀, etc.; optional).
|-
|style="vertical-align:top;"| '''s'''  || A suffix for the value (such as %, optional).
:Prefixes (specified by '''p''') and suffixes (specified by '''s''') are put in front of or behind the value ''as is'': this includes spaces. They are inside the ''nowrap'' block and will always be on the same line as the value. The parameters that previously provided this functionality ('''h''' for header and '''f''' for footer) are ''deprecated'' and will be ignored.
|-
|-
|style="vertical-align:top;"| '''end''' || Appends something after the main value. For example, <nowiki>{{val|123.24|end=...}}</nowiki> gives {{val|123.24|end=...}}
|-
|style="vertical-align:top;"| '''errend''' || Appends something after the uncertainty. For example, <nowiki>{{val|123.23|end=...|2.34|errend=...}}</nowiki> gives {{val|123.23|end=...|2.34|errend=...}}
|-
|style="vertical-align:top;"| {{nowrap|'''+errend'''}} & {{nowrap|'''-errend'''}} || Appends something after the positive/negative uncertainties. For example, <nowiki>{{val|123.23|end=...|+2.34|+errend=...|-1.23|-errend=...}}</nowiki> gives {{val|123.23|end=...|+2.34|+errend=...|-1.23|-errend=...}}
|}

== Errors ==
There is strict checking on the validity of arguments; any incorrect use will result in an error, which is displayed using {{tl|Formatting error}}.

== Format convention ==
{{tl|val}} should produce formatting compliant with the ''U.S. Government Printing Office Style Manual'', in [http://frwebgate.access.gpo.gov/cgi-bin/getdoc.cgi?dbname=2008_style_manual&docid=f:chapter12.pdf rules 12.9e and 12.14], which requires that the [[w:decimal separator|decimal separator]] be a [[w:full stop|full stop]]; i.e. “decimal point” (.), requires comma-delimiting to the left of the decimal point for numbers with four or more digits to the left (values of {{val|1000}} or more), and also requires space-delimiting to the right of the decimal point for numbers containing five or more digits to the right (e.g., {{val|0.12345}} and {{val|5.12345}} and {{val|125.12345}}).

Note that if <nowiki>{{val}}</nowiki> is used on numbers simultaneously comprising four or more digits to the left of the decimal point ''and'' five or more digits to the right, the resultant expression will delimited with commas left and spaces (actually non-selectable, non-breaking, narrow gaps) right (see below).

== Examples ==
:{|
|-
|<code><nowiki>{{val|1234567890}}</nowiki></code>||&nbsp;→&nbsp;||{{val|1234567890}}
|-
|<code><nowiki>{{val|1.23456789}}</nowiki></code>||&nbsp;→&nbsp;||{{val|1.23456789}}
|-
|<code><nowiki>{{val|21563.252564425}}</nowiki></code>||&nbsp;→&nbsp;||{{val|21563.252564425}}
|-
|colspan="3"|'''Uncertainty/significance'''
|-
|<code><nowiki>{{val|1.234|0.005}}</nowiki></code>||&nbsp;→&nbsp;||{{val|1.234|0.005}}
|-
|<code><nowiki>{{val|1.234|+0.005|-0.006}}</nowiki></code>||&nbsp;→&nbsp;||{{val|1.234|+0.005|-0.006}}
|-
|<code><nowiki>{{val|1.234|(5)}}</nowiki></code>||&nbsp;→&nbsp;||{{val|1.234|(5)}}
|-
|colspan="3"|'''Exponents/units'''
|-
|<code><nowiki>{{val|1.234|e=5|u=m}}</nowiki></code>||&nbsp;→&nbsp;||{{val|1.234|e=5|u=m}}
|-
|<code><nowiki>{{val|1.234|e=5|u=m2}}</nowiki></code>||&nbsp;→&nbsp;||{{val|1.234|e=5|u=m2}}
|-
|<code><nowiki>{{val|1.234|e=5|ul=m}}</nowiki></code>||&nbsp;→&nbsp;||{{val|1.234|e=5|ul=m}}
|-
|<code><nowiki>{{val|1.234|0.056|e=7}}</nowiki></code>||&nbsp;→&nbsp;||{{val|1.234|0.056|e=7}}
|-
|<code><nowiki>{{val|1.23456|+0.00007|-0.00008|e=-9|ul=m/s}}</nowiki></code>||&nbsp;→&nbsp;||{{val|1.23456|+0.00007|-0.00008|e=-9|ul=m/s}}
|-
|<code><nowiki>{{val|1.234|0.056|e=7|ul=psi}}</nowiki></code>||&nbsp;→&nbsp;||{{val|1.234|0.056|e=7|ul=psi}}
|-
|<code><nowiki>{{val|123.4|ul=USgal}}</nowiki></code>||&nbsp;→&nbsp;||{{val|123.4|ul=USgal}}
<!-- |-
|<code><nowiki>{{val|12.34|ul=mpgimp}}</nowiki></code>||&nbsp;→&nbsp;||{{val|12.34|ul=mpgimp}}-->
|-
|colspan="3"|'''Prefix/suffix'''
|-
|<code><nowiki>{{val|p=Δ&amp;nbsp;|12.34|s=%}}</nowiki></code>||&nbsp;→&nbsp;||{{val|p=Δ&nbsp;|12.34|s=%}}
|}

==Performance impact==
For most uses, in the text of pages, Template:Val will not restrict performance, but when used inside the wikitext markup of large templates, there are some restrictions. When displaying integer amounts, Template:Val has an internal [[m:Help:Expansion depth|expansion depth]] of 15 levels, but for numbers with decimal portions, it uses 22 levels, or more.

== See also ==
* {{tl|Valid}} : number validity checking (for parameters 1, 2, 3, e : value, and uncertainties, base-10 exponent)
* {{tl|Formatting error}} : for reporting inconsistent parameters
* {{tl|Su}} : for formatting exponents, or two-values incertainty one below the other (monospaced : currently not printable to PDF)
* {{tl|±}} : for positive <tt><nowiki><sup></nowiki></tt> and negative <tt><nowiki><sub></nowiki></tt>
* {{tl|Val/delimitnum}} : for formatting a decimal number with delimiters between groups of digits
* {{tl|Val/units}} : for formatting unit names (contents of parameters <tt>u</tt> or <tt>up</tt>)
* {{tl|Val/unitswithlink}} : for formatting unit names with links (contents of parameters <tt>ul</tt> or <tt>upl</tt>)
<includeonly>
[[Category:Text formatting templates|Val]]
</includeonly>