Jump to content

Module:Yesno/doc: Difference between revisions

Add links
Browse history interactively
Majestix (talk | contribs)
Bureaucrats, Interface administrators, Administrators
171 edits
Content deleted Content added
VisualWikitext
m rm {{Shared Template Warning}}.
 
Marked this version for translation
 
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
<languages/>
⚫
<translate>
⚫
<!--T:35-->
<noinclude><!--
<noinclude><!--
-->{{#ifeq:{{SUBPAGENAME}}|doc||{{Documentation subpage}}}}<!--
-->{{#ifeq:{{SUBPAGENAME}}|doc||{{Documentation subpage}}}}<!--
--><languages /><!--
--><!--
--></noinclude>{{#switch:<translate></translate>
--></noinclude>{{#switch:
| =
| =
<includeonly>{{Languages|Module:Yesno/doc}}</includeonly>
<includeonly></includeonly>
<!-- Add categories where indicated at the bottom of this page and interwikis at Wikidata -->
<!-- Add categories where indicated at the bottom of this page and interwikis at Wikidata -->
⚫
</translate>
{{high-risk}}
{{high-risk}}
{{used in system}}
{{used in system}}
{{Module rating|release}}
{{Module rating|release}}
{{Module rating|protected}}
{{Module rating|protected}}
⚫
<translate><!--T:1--> This module provides a consistent interface for processing boolean or boolean-style string input.</translate>
⚫
<translate><!--T:2--> While Lua allows the <tvar name=1><code>true</code></tvar> and <tvar name=2><code>false</code></tvar> boolean values, wikicode templates can only express boolean values through strings such as <tvar name=3>"1"</tvar>, <tvar name=4>"0"</tvar>, <tvar name=5>"yes"</tvar>, <tvar name=6>"no"</tvar>, etc.</translate>
⚫
<translate><!--T:3--> This module processes these kinds of strings and turns them into boolean input for Lua to process.</translate>
⚫
<translate><!--T:4--> It also returns <tvar name=1><code>nil</code></tvar> values as <tvar name=1><code>nil</code></tvar>, to allow for distinctions between <tvar name=1><code>nil</code></tvar> and <tvar name=2><code>false</code></tvar>.</translate>
⚫
<translate><!--T:5--> The module also accepts other Lua structures as input, i.e. booleans, numbers, tables, and functions.</translate>
⚫
<translate><!--T:6--> If it is passed input that it does not recognise as boolean or <tvar name=1><code>nil</code></tvar>, it is possible to specify a default value to return.</translate>
<translate>
<translate>
== Module Quality == <!--T:34-->
<!--T:36-->
⚫
This module provides a consistent interface for processing boolean or boolean-style string input.
⚫
While Lua allows the <code>true</code> and <code>false</code> boolean values, wikicode templates can only express boolean values through strings such as "1", "0", "yes", "no", etc.
⚫
This module processes these kinds of strings and turns them into boolean input for Lua to process.
⚫
It also returns <code>nil</code> values as <code>nil</code>, to allow for distinctions between <code>nil</code> and <code>false</code>.
⚫
The module also accepts other Lua structures as input, i.e. booleans, numbers, tables, and functions.
⚫
If it is passed input that it does not recognise as boolean or <code>nil</code>, it is possible to specify a default value to return.

⚫
== Module Quality == <!--T:37-->

</translate>
</translate>
{{ModuleQuality}}
{{ModuleQuality}}
<translate>
<translate>

⚫
== Syntax == <!--T:33-->
⚫
== Syntax == <!--T:38-->
⚫
</translate>

⚫
<!--T:39-->
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
yesno(value, default)
yesno(value, default)
</syntaxhighlight>
</syntaxhighlight>


<!--T:40-->
<translate><!--T:7--> <tvar name=1><code>value</code></tvar> is the value to be tested.</translate>
<code>value</code> is the value to be tested.
<translate><!--T:8--> Boolean input or boolean-style input (see below) always evaluates to either <tvar name=1><code>true</code></tvar> or <tvar name=2><code>false</code></tvar>, and <tvar name=3><code>nil</code></tvar> always evaluates to <tvar name=3><code>nil</code></tvar>.</translate>
Boolean input or boolean-style input (see below) always evaluates to either <code>true</code> or <code>false</code>, and <code>nil</code> always evaluates to <code>nil</code>.
<translate><!--T:9--> Other values evaluate to <tvar name=1><code>default</code></tvar>.</translate>
Other values evaluate to <code>default</code>.
⚫
<translate>

⚫
== Usage == <!--T:10-->
== Usage == <!--T:41-->
⚫
</translate>

⚫
<translate><!--T:11--> First, load the module. Note that it can only be loaded from other Lua modules, not from normal wiki pages.</translate>
<!--T:42-->
⚫
<translate><!--T:12--> For normal wiki pages you can use <tvar name=1>{{tlx|yesno}}</tvar> instead.</translate>
⚫
First, load the module. Note that it can only be loaded from other Lua modules, not from normal wiki pages.
⚫
For normal wiki pages you can use {{tlx|yesno}} instead.


<!--T:43-->
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
local yesno = require('Module:Yesno')
local yesno = require('Module:Yesno')
</syntaxhighlight>
</syntaxhighlight>


<!--T:44-->
<translate><!--T:13--> Some input values always return <tvar name=1><code>true</code></tvar>, and some always return <tvar name=2><code>false</code></tvar>.</translate>
<translate><!--T:14--> <tvar name=1><code>nil</code></tvar> values always return <tvar name=1><code>nil</code></tvar>.</translate>
Some input values always return <code>true</code>, and some always return <code>false</code>.
<code>nil</code> values always return <code>nil</code>.


<!--T:45-->
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
-- <translate nowrap><!--T:15--> These always return <tvar name=1>true</tvar>:</translate>
-- These always return true:
yesno('yes')
yesno('yes')
yesno('y')
yesno('y')
Line 53: Line 67:
yesno(true)
yesno(true)


<!--T:46-->
-- <translate nowrap><!--T:16--> These always return <tvar name=1>false</tvar>:</translate>
-- These always return false:
yesno('no')
yesno('no')
yesno('n')
yesno('n')
Line 62: Line 77:
yesno(false)
yesno(false)


<!--T:47-->
-- <translate nowrap><!--T:17--> A <tvar name=1>nil</tvar> value always returns <tvar name=1>nil</tvar>:</translate>
-- A nil value always returns nil:
yesno(nil)
yesno(nil)
</syntaxhighlight>
</syntaxhighlight>
⚫
<translate>
⚫
<!--T:18-->
String values are converted to lower case before they are matched:
String values are converted to lower case before they are matched:
⚫
</translate>
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
-- <translate nowrap><!--T:19--> These always return <tvar name=1>true</tvar>:</translate>
-- These always return true:
yesno('Yes')
yesno('Yes')
yesno('YES')
yesno('YES')
Line 77: Line 90:
yesno('tRuE')
yesno('tRuE')


<!--T:48-->
-- <translate nowrap><!--T:20--> These always return <tvar name=1>false</tvar>:</translate>
-- These always return false:
yesno('No')
yesno('No')
yesno('NO')
yesno('NO')
Line 85: Line 99:
</syntaxhighlight>
</syntaxhighlight>


<!--T:49-->
<translate><!--T:21--> You can specify a default value if <tvar name=1><code>yesno</code></tvar> receives input other than that listed above.</translate>
You can specify a default value if <code>yesno</code> receives input other than that listed above.
<translate><!--T:22--> If you don't supply a default, the module will return <tvar name=1><code>nil</code></tvar> for these inputs.</translate>
If you don't supply a default, the module will return <code>nil</code> for these inputs.


<!--T:50-->
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
-- <translate nowrap><!--T:23--> These return <tvar name=1>nil</tvar>:</translate>
-- These return nil:
yesno('foo')
yesno('foo')
yesno({})
yesno({})
Line 95: Line 111:
yesno(function() return 'This is a function.' end)
yesno(function() return 'This is a function.' end)


<!--T:51-->
-- <translate nowrap><!--T:24--> These return <tvar name=1>true</tvar>:</translate>
-- These return true:
yesno('foo', true)
yesno('foo', true)
yesno({}, true)
yesno({}, true)
Line 101: Line 118:
yesno(function() return 'This is a function.' end, true)
yesno(function() return 'This is a function.' end, true)


<!--T:52-->
-- <translate nowrap><!--T:25--> These return <tvar name=1>"bar"</tvar>:</translate>
-- These return "bar":
yesno('foo', 'bar')
yesno('foo', 'bar')
yesno({}, 'bar')
yesno({}, 'bar')
Line 107: Line 125:
yesno(function() return 'This is a function.' end, 'bar')
yesno(function() return 'This is a function.' end, 'bar')
</syntaxhighlight>
</syntaxhighlight>
<translate>
⚫
<!--T:26-->
Note that the blank string also functions this way:
Note that the blank string also functions this way:
</translate>
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
yesno('') -- <translate nowrap><!--T:27--> Returns <tvar name=1>nil</tvar>.</translate>
yesno('') -- Returns nil.
yesno('', true) -- <translate nowrap><!--T:28--> Returns <tvar name=1>true</tvar>.</translate>
yesno('', true) -- Returns true.
yesno('', 'bar') -- <translate nowrap><!--T:29--> Returns <tvar name=1>"bar"</tvar>.</translate>
yesno('', 'bar') -- Returns "bar".
</syntaxhighlight>
</syntaxhighlight>


<!--T:53-->
<translate><!--T:30--> Although the blank string usually evaluates to <tvar name=1><code>false</code></tvar> in wikitext, it evaluates to <tvar name=2><code>true</code></tvar> in Lua.</translate>
Although the blank string usually evaluates to <code>false</code> in wikitext, it evaluates to <code>true</code> in Lua.
<translate><!--T:31--> This module prefers the Lua behaviour over the wikitext behaviour.</translate>
This module prefers the Lua behaviour over the wikitext behaviour.
<translate><!--T:32--> If treating the blank string as <tvar name=1><code>false</code></tvar> is important for your module, you will need to remove blank arguments at an earlier stage of processing.</translate>
If treating the blank string as <code>false</code> is important for your module, you will need to remove blank arguments at an earlier stage of processing.
<includeonly>{{Sandbox other||
<includeonly>{{Sandbox other||
<!-- Categories below this line; interwikis at Wikidata -->
<!-- Categories below this line; interwikis at Wikidata -->

⚫
</translate>
[[Category:Modules]]
[[Category:Modules]]
}}</includeonly><noinclude>
}}</includeonly><noinclude>
[[Category:Module documentation pages{{#translation:}}]]
[[Category:Module documentation pages{{#translation:}}{{#translation:}}]]
⚫
<translate>

<!--T:54-->
</noinclude>
</noinclude>
| #default=
| #default=
{{#invoke:Template translation|renderTranslatedTemplate|template=Module:Yesno/doc|noshift=1|uselang={{int:lang}}}}
{{#invoke:Template translation|renderTranslatedTemplate|template=Module:Yesno/doc|noshift=1|uselang={{int:lang}}}}
}}
}}
⚫
</translate>
Retrieved from "https://compusofia.com/wiki/Module:Yesno/doc"