Шаблон:Val/doc

Шаблон {{val}} (от англ. value — значение) предназначен для облегчения записи значений физических величин с возможностью указания погрешностей измерения (о разных формах записи погрешности см. статью Погрешность измерения) и единиц измерения. Шаблон запрещает перевод строки от начала и до конца выводимого шаблоном текста. Все численные значения, кроме указываемых в параметрах d и e (см. ниже), обрабатываются функцией парсера {{formatnum:}}.

Использование

Шаблон имеет следующие параметры (все — необязательные):

Параметр	Описание
v (от value)	Числовое значение величины или (при использовании параметра e) мантисса этого значения в экспоненциальной записи. Замечание: если значение записывается с использованием десятичной дроби, следует обязательно использовать десятичную точку, а не запятую, так как оно обрабатывается функцией парсера {{formatnum:}}.
pm (от plus-minus)	Значение погрешности измерения («плюс-минус»). Замечание выше (о десятичной точке) относится и к этому параметру.
p и m	Раздельные значения погрешности измерения «в плюс» и «в минус»; выводятся как верхний и нижний индексы (со знаками «+» и «−», соответственно) после числового значения величины. Если задан параметр pm, то эти параметры игнорируются. При указании параметра p необходимо также указать и m, и наоборот. Замечание выше (о десятичной точке) относится и к этим параметрам.
d (от ??)	Погрешность в форме записи, удобной для величин, известных с большой точностью; записывается как число в скобках после числового значения величины.
e (от exponent)	Порядок для экспоненциальной записи значения величины.
u (от unit)	Единица измерения указываемой величины.

Для упрощения вики-кода вместо параметра v можно пользоваться первым неименованным параметром, вместо pm — вторым, вместо пары p+m — вторым+третьим. При указании неименованных параметров соответствующие им именованные параметры игнорируются. Подробнее см. в разделе «Примеры использования» ниже.

Описание параметров шаблона для Визуального редактора

Шаблон {{val}} (от англ. value — «значение») предназначен для облегчения записи значений физических величин с возможностью указания погрешностей измерения и единиц измерения

Параметры шаблона

Параметр		Описание	Тип	Статус
Значение	1	Числовое значение величины или (при использовании параметра «e») мантисса этого значения в экспоненциальной записи.	Число	необязательный
Погрешность (± или +)	2	Общее значение погрешности («плюс-минус») или погрешность «в плюс» (верхний индекс); в последнем случае обязательно задать и параметр 3.	Число	необязательный
Погрешность (−)	3	Погрешность «в минус» (нижний индекс); если этот параметр задан, то обязательно должен быть задан и параметр 2.	Число	необязательный
Значение	v	Числовое значение величины или (при использовании параметра «e») мантисса этого значения в экспоненциальной записи; можно использовать вместо неименованного параметра 1.	Число	необязательный
Погрешность (±)	pm	Общее значение погрешности («плюс-минус»); можно использовать вместо неименованного параметра 2.	Число	необязательный
Погрешность (+)	p	Погрешность «в плюс»; можно использовать вместо неименованного параметра 2. Если задан параметр «pm», то параметры «p» и «m» игнорируются. Если параметр «p» задан, то обязательно должен быть задан и параметр «m».	Число	необязательный
Погрешность (−)	m	Погрешность «в минус»; можно использовать вместо неименованного параметра 3. Если параметр «m» задан, то обязательно должен быть задан и параметр «p».	Число	необязательный
Погрешность (в скобках)	d	Погрешность в форме записи, удобной для величин, известных с большой точностью; записывается как число в скобках после значения.	Число	необязательный
Порядок величины (10^N)	e	Порядок для экспоненциальной записи значения величины.	Число	необязательный
Единица измерения	u	Единица измерения указываемой величины.	Строковый (без форматирования)	необязательный

Примеры использования

Примеры случаев, в которых оправдано использование данного шаблона:

	Код	Результат
1	Значение величины (в экспоненциальной записи) с указанием погрешности, а также единицы измерения: {{val|v=1.234|pm=0.002|e=6|u=[[Километр|км]]}}	(1,234 ± 0,002)⋅106 км
2	То же, что в примере 1, но с указанием различной погрешности «в плюс» и «в минус»: {{val|v=1.234|p=0.002|m=0.003|e=6|u=[[Километр|км]]}}	(1,234+0,002 −0,003)⋅106 км
3	То же, что в примере 1, но с указанием погрешности «в скобках» (удобно, когда значение величины известно с высокой точностью): {{val|v=1.2345678|d=14|e=6|u=[[Километр|км]]}}	1,2345678(14)⋅106 км
4	То же, что в примере 1, но не в экспоненциальной, а в обычной записи: {{val|v=123450000|pm=10000|u=[[Километр|км]]}}	123 450 000 ± 10 000 км
5	C использованием неименованных параметров: {{val|12345|6|u=[[Километр|км]]}} {{val|12345|7|9|u=[[Километр|км]]}}	12 345 ± 6 км 12 345+7 −9 км

Примеры простых случаев; этот шаблон поддерживает и их, хотя его использование может быть неоправданным, и лучше использовать вместо него более простые шаблоны:

	Код	Результат	Альтернатива
1	Просто число: {{val|12345}}	12 345	Функция парсера {{formatnum:}} или шаблон {{число}} (он же {{num}}) {{formatnum: 12345}} → 12 345 {{num|12345}} → 12 345
2	Число с единицей измерения: {{val|12345|u=м/с}}	12 345 м/с	Шаблон {{число}} (он же {{num}}) {{num|12345|м/с}} → 12 345 м/с
3	Число (четырёх- или менее значное) с указанием разброса и без указания единицы измерения: {{val|123|7|13}}	123+7 −13	Шаблон {{sup sub}} или {{su}} 123{{sup sub|+7|−13}} → 123+7 −13 123{{su|p=+7|b=−13}} → 123+7 −13

См. также

• Шаблон {{число}} (и записываемое латиницей перенаправление на него {{num}}) — более простой шаблон, реализующий часть функциональности данного шаблона.