Модуль:Yesno
Внимание! Это один из самых используемых модулей. |
Данный модуль предоставляет единый интерфейс для обработки булевых или булевоподобных входных данных. Lua позволяет использовать логические значения КатегорияШаблоны:Языки программирования и , в то время как шаблоны, написанные с помощью вики-разметки, часто используют обозначения, подобные «yes» и «no». Модуль преобразует подобные строки и выдаёт булевскую величину, пригодную для использования в Lua. Кроме того, возможно возвращаемое значение КатегорияШаблоны:Языки программирования. В качестве входных данных могут использоваться другие структуры Lua, в том числе булевы переменные, числа, таблицы и функции. Кроме того, можно задать возвращаемое значение по умолчанию.
Синтаксис[править]
КатегорияШаблоны:Языки программирования
value
— проверяемая величина. Булевские и им подобные входные данные всегда приводят к
КатегорияШаблоны:Языки программирования или
,
КатегорияШаблоны:Языки программирования возвращает
КатегорияШаблоны:Языки программирования. Остальным случаям соответствует default
.
Использование[править]
Для начала, загрузите модуль. Обратите внимание, что это можно сделать только из других модулей.
local yesno = require('Module:Yesno')
Некоторые значения всегда возвращают КатегорияШаблоны:Языки программирования, некоторые другие — . КатегорияШаблоны:Языки программирования всегда возвращает КатегорияШаблоны:Языки программирования. КатегорияШаблоны:Языки программирования
Строковые значения предварительно преобразуются к нижнему регистру: КатегорияШаблоны:Языки программирования
Если yesno принимает аргумент, отличный от перечисленных выше, вы можете задать значение по умолчанию. Если оно не задано, для них будет возвращаться КатегорияШаблоны:Языки программирования. КатегорияШаблоны:Языки программирования
Обратите внимание на поведение при передаче пустой строки: КатегорияШаблоны:Языки программирования
Хотя пустая строка в викитексте соответствует , Lua ставит ей в соответствие КатегорияШаблоны:Языки программирования. Так же поступает и модуль. Поэтому для избежания подобных ошибок пустые строки должны отсеиваться до применения данного модуля.
См. также[править]
- Шаблон:Yesno — шаблон с аналогичным функционалом, применяемый в других шаблонах, а не модулях; использует напрямую {{#switch}}
-- Function allowing for consistent treatment of boolean-like wikitext input.
-- It works similarly to the template {{yesno}}.
return function (val, default)
-- If your wiki uses non-ascii characters for any of "yes", "no", etc., you
-- should replace "val:lower()" with "mw.ustring.lower(val)" in the
-- following line.
val = type(val) == 'string' and val:lower() or val
if val == nil then
return nil
elseif val == true
or val == 'yes'
or val == 'y'
or val == 'true'
or val == 't'
or val == 'да'
or val == 'д'
or val == '+'
or tonumber(val) == 1
then
return true
elseif val == false
or val == 'no'
or val == 'n'
or val == 'false'
or val == 'f'
or val == 'нет'
or val == 'н'
or val == '-'
or tonumber(val) == 0
then
return false
else
return default
end
end