K3info: 1 версия импортирована

2020-10-29T10:52:55Z

1 версия импортирована

← Предыдущая версия	Версия от 13:52, 29 октября 2020
(нет различий)

176.122.109.150: Внимание! Это один из самых используемых модулей.

2019-11-23T13:21:42Z

Внимание! Это один из самых используемых модулей.

Новая страница

{{СИШ}}
Данный модуль предоставляет единый интерфейс для обработки булевых или булевоподобных входных данных. Lua позволяет использовать логические значения <code>true</code> и <code>false</code>, в то время как шаблоны, написанные с помощью вики-разметки, часто используют обозначения подобные «yes» и «no». Модуль преобразует подобные строки и выдаёт булевскую величину, пригодную для использования в Lua. Кроме того возможно возвращаемое значение <code>nil</code>. В качестве входных данных могут использоваться другие структуры Lua, в том числе булевы переменные, числа, таблицы и функции. Кроме того можно задать возвращаемое значение по умолчанию.

== Синтаксис ==
<source lang="lua">yesno(value, default)</source>

<code>value</code> — проверяемая величина. Булевские и им подобные входные данные всегда приводят к <code>true</code> или <code>false</code>, <code>nil</code> возвращает <code>nil</code>. Остальным случаям соответствует <code>default</code>.

== Использование ==
Для начала, загрузите модуль. Обратите внимание, что это можно сделать только из других модулей.

<source lang="lua">
local yesno = require('Module:Yesno')
</source>

Некоторые значения всегда возвращают <code>true</code>, некоторые другие — <code>false</code>. <code>nil</code> всегда возвращает <code>nil</code>.

<source lang="lua">
-- Всегда возвращают true:
yesno('yes')
yesno('y')
yesno('true')
yesno('t')
yesno('да')
yesno('д')
yesno('+')
yesno('1')
yesno(1)
yesno(true)

-- Всегда возвращают false:
yesno('no')
yesno('n')
yesno('false')
yesno('f')
yesno('нет')
yesno('н')
yesno('-')
yesno('0')
yesno(0)
yesno(false)

-- nil всегда возвращает nil:
yesno(nil)
</source>

Строковые значения предварительно преобразуются к нижнему регистру:

<source lang="lua">
-- Всегда возвращают true:
yesno('Yes')
yesno('YES')
yesno('yEs')
yesno('Y')
yesno('tRuE')

-- Всегда возвращают false:
yesno('No')
yesno('NO')
yesno('nO')
yesno('N')
yesno('fALsE')
</source>

Если yesno принимает аргумент отличный от перечисленных выше, вы можете задать значение по умолчанию. Если оно не задано, для них будет возвращаться <code>nil</code>.

<source lang="lua">
-- возвращают nil:
yesno('foo')
yesno({})
yesno(5)
yesno(function() return 'This is a function.' end)

-- возвращают true:
yesno('foo', true)
yesno({}, true)
yesno(5, true)
yesno(function() return 'This is a function.' end, true)

-- возвращают "bar":
yesno('foo', 'bar')
yesno({}, 'bar')
yesno(5, 'bar')
yesno(function() return 'This is a function.' end, 'bar')
</source>

Обратите внимание на поведение при передаче пустой строки:
<source lang="lua">
yesno('') -- Returns nil.
yesno('', true) -- Returns true.
yesno('', 'bar') -- Returns "bar".
</source>

Хотя пустая строка в викитексте соответствует false, Lua ставит ей в соответствие true. Так же поступает и модуль. Поэтому для избежания подобных ошибок пустые строки должны отсеиваться до применения данного модуля.
<includeonly>[[Категория:Модули:Базовые]]</includeonly>
<noinclude>[[Категория:Модули:Документация]]</noinclude>

Модуль:Yesno/doc - История изменений

K3info: 1 версия импортирована

176.122.109.150: Внимание! Это один из самых используемых модулей.