Karaby в 07:37, 21 июня 2021

2021-06-21T07:37:05Z

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

Karaby: Новая страница: «{{СИШ}} Данный модуль предоставляет единый интерфейс для обработки булевых или булевопод…»

2021-06-21T07:36:47Z

Новая страница: «{{СИШ}} Данный модуль предоставляет единый интерфейс для обработки булевых или булевопод…»

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

{{СИШ}}
Данный модуль предоставляет единый интерфейс для обработки булевых или булевоподобных входных данных. 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 - История изменений

Karaby в 07:37, 21 июня 2021

Karaby: Новая страница: «{{СИШ}} Данный модуль предоставляет единый интерфейс для обработки булевых или булевопод…»