Шаблон:Val/документація

Використання

Цей шаблон використовується для зручності представлення наукової інформації, включаючи неточності даних та їх одиниць вимірювання згідно до вимог щодо стилю Вікіпедії. Шаблон розміщує результат в блок {{nowrap}}, так що він ніколи не буде розбитим на кілька частин в незалежності від місця розташування в тексті. (Див.також en:WP:NBSP для більш детальної інформації про використання нероздільних частин тексту.)

Аргументи

Існує чотири методи використання цього шаблону:

• {{val|''число''}} - для показу числового значення без помилок чи значимості величини.
• {{val|''число''|''розмах помилок''}} - для показу числового значення з розмахом помилок (певною точністю), приклад 7003123400000000000♠1234±56.
• {{val|''число''|''верхня межа помилки''|''нижня межа помилки''}} - для показу числового значення з розмахом помилок (певною точністю), приклад 7003123400000000000♠1234+56
  −78.
• {{val|''число''|(''значимість'')}} - для показу числового значення зі значимістю величини, приклад 7003123400000000000♠1234(56).

Всі вони мають однакові аргументи

1	Значення (мусить бути дійсним числом)
2	Верхня межа помилки (мусить бути дійсним числом) чи значимість (мусить бути дійсним числом в дужках)
3	Нижня межа помилки чи значимість (мусить бути дійсним числом)
e	Експонента за основою 10 (вибірково). Результат буде показано у вигляді " × 10e".
	Значення (аргументи 1-3 та e) опрацбвуються кодом зкопійованим з шаблону {{delimitnum}} для зручності читання, за виключенням аргументу 2, коли він взятий у дужками. На сьогоднішній день це зпричинює помилки при використанні великих чисел, чисел, що потребують високої точності, та чисел, що містять нуль безпосередньо після десятичної крапки.
u / ul	Одиниця вимірювання для заданої величини (вибірково) використовується відповідно з та без посилання на сторінку з описом цієї одиниці.
up / upl	Одиниця вимірювання на одиницю вимірювання як розмірність заданої величини (вибірково, потребує специфікацію аргументу u) використовується відповідно з та без посилання на сторінку з описом цієї розмірності чи одиниць.
	Одиниці вимірювання (специфіковані u, ul, up та upl) відображаються естетично й дають посилання (ul та upl) тільки тоді, коли вони входять до переліку в {{val/units}} чи коли вони підтримуються {{convert}}). Ви можете специфікувати одиниці тільки за через u; гарним прикладом є "ul=м/сек", яка перетворюється в "м·сек-1", або ви можете використати u та up, як "u/up"; гарним прикладом є "ul=м|up=сек", які конвертуються в "м/сек".
p	Префікс величини (такий як ∆, Ø, etc.., вибірково).
s	Суфікс величини (такий як %, вибірково).
	Префікси (задані p) та суфікси (задані s) відображаються спереду чи позаду значення у такому ж вигляді як їх подано: це ж стосується й пробілів. Вони також знаходяться всередині блоку nowrap й завше будуть розміщені разом зі заданим значенням в одному рядку. Параметри, що раніше забезпечували реалізацію цієї можливості (h для заголовку та f для закінчення), є задавленими й будуть ігноруватися.
end	Приєднує щось після самої величини. Наприклад, {{val|123.24|end=...}} видає 7002123240000000000♠123.24...
errend	Приєднує щось після неточності (даних розмаху помилок). Наприклад, {{val|123.23|end=...|2.34|errend=...}} видає 7002123230000000000♠123.23...±2.34...
+errend & -errend	Приєднує щось після позитивної чи негативеої неточності. Наприклад, {{val|123.23|end=...|+2.34|+errend=...|-1.23|-errend=...}} видає 7002123230000000000♠123.23...+2.34... −1.23...
nocategory	Коли цьому аргументу присвоєне будь-яке значення, то помилка використання цього шаблону не спричиняє додавання категорії Сторінки з помилками використання шаблонів форматування. Це може бути корисним для написання документації чи тестової сторінки, котрі не треба виправляти.

Дивіться також {{val/test}} для прикладів правильного виводу шаблону {{val}} та для помилок, котрі можуть виникати при виводі даних при неправильному використанні шаблону.

Помилки

Шаблон містить перевірку на дійсність аргументів. Будь-яке неправильне використання приведе до помилки, яку буде показано за допомогою шаблону {{FormattingError}}. Сторінки, що містять неправильне використання цього шаблону, буде показано в категорії Сторінки з помилками використання шаблонів форматування.

Приклади

{{val|1234567890}}	→	7009123456789000000♠1234567890
{{val|1.23456789}}	→	7000123456788999999♠1.23456789
Неточність/значимість результату
{{val|1.234|0.005}}	→	7000123400000000000♠1.234±0.005
{{val|1.234|+0.005|-0.006}}	→	7000123400000000000♠1.234+0.005 −0.006
{{val|1.234|(5)}}	→	7000123400000000000♠1.234(5)
Експоненти/одиниці вимірювання
{{val|1.234|e=5|u=м}}	→	7005123400000000000♠1.234×105 м
{{val|1.234|e=5|u=м2}}	→	7005123400000000000♠1.234×105 м2
{{val|1.234|e=5|ul=м}}	→	7005123400000000000♠1.234×105 м
{{val|1.234|0.056|e=7}}	→	7007123400000000000♠(1.234±0.056)×107
{{val|1.23456|+0.00007|-0.00008|e=-9|ul=м/сек}}	→	6991123456000000000♠1.23456+0.00007 −0.00008×10−9 м/сек
{{val|1.234|0.056|e=7|ul=psi}}	→	7010850813049976975♠(1.234±0.056)×107 psi
{{val|123.4|ul=USgal}}	→	6999467119814145600♠123.4 US gal
{{val|12.34|ul=mpgimp}}	→	6993228914859264037♠12.34 mpg-imp
Префікси/суфікси
{{val|p=Δ |12.34|s=%}}	→	7001123400000000000♠Δ 12.34%

Див. також

• {{val/units}}
• {{val/unitswithlink}}
• {{val/delimitnum}}
• {{val/delimitnum/firstgroup}}
• {{val/delimitnum/group}}
• {{val/delimitnum/logic}}
• {{val/delimitnum/real}}