Шаблон: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)⋅10⁶ км
2	То же, что в примере 1, но с указанием различной погрешности «в плюс» и «в минус»: `{{val\|v=1.234\|p=0.002\|m=0.003\|e=6\|u=[[Километр\|км]]}}`	(1,234+0,002 −0,003)⋅10⁶ км
3	То же, что в примере 1, но с указанием погрешности «в скобках» (удобно, когда значение величины известно с высокой точностью): `{{val\|v=1.2345678\|d=14\|e=6\|u=[[Километр\|км]]}}`	1,2345678(14)⋅10⁶ км
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}}) — более простой шаблон, реализующий часть функциональности данного шаблона.