MechsploWikiSysop: 1 revision imported

2025-09-04T07:24:45Z

1 revision imported

← Older revision	Revision as of 03:24, 4 September 2025
(No difference)

mw>Aamrs: Created page with "Se tratar a ''string'' em branco como $1 é importante para o seu módulo, terá de remover os argumentos em branco numa fase anterior do processamento."

2025-07-26T10:37:13Z

Created page with "Se tratar a ''string'' em branco como $1 é importante para o seu módulo, terá de remover os argumentos em branco numa fase anterior do processamento."

New page

<noinclude>{{#ifeq:{{SUBPAGENAME}}|doc||{{Documentation subpage}}}}<languages /></noinclude>{{#switch:
| =
<includeonly>{{Languages|Module:Yesno/doc}}</includeonly>

{{Shared Template Warning}}
{{high-risk}}
{{used in system}}
{{Module rating|release}}
{{Module rating|protected}}
Este módulo fornece uma interface consistente para o processamento de booliano e da entrada de ''string'' ao estilo de boolinao.
Enquanto Lua permite os valores boolianos <code>true</code> e <code>false</code>, os modelos do código wiki só podem expressar os valores boolianos através de ''strings'', tais como "1", "0", "yes", "no", etc.
Este módulo processa estes tipos de ''strings'' e transforma-as numa entrada booliana para Lua processar.
Este também devolve valores <code>nil</code> como <code>nil</code>, para permitir distinções entre <code>nil</code> e <code>false</code>.
Este módulo aceita outras estruturas de Lua como entrada, por exemplo, boolianos, números, tabelas, e funções.
Se for passada uma entrada que não reconhece como booliano ou <code>nil</code>, é possível especificar um valor predefinido para devolver.

== Qualidade do Módulo ==
{{ModuleQuality}}

== Sintaxe ==
<syntaxhighlight lang="lua">
yesno(value, default)
</syntaxhighlight>

<code>value</code> é o valor a ser testado.
A entrada booliana ou entrada no estilo booliano (veja em baixo) aponta sempre para <code>true</code> ou <code>false</code>, e <code>nil</code> aponta sempre para <code>nil</code>.
Outros valores apontam para <code>default</code>.

== Utilização ==
Primeiro, carregue o módulo. Note que este só pode ser carregado de outros módulos de Lua, não das páginas wiki normais.
Em vez disso, para as páginas wiki normais pode utilizar {{tlx|yesno}}.

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

Alguns valores de entrada devolvem sempre <code>true</code>, e alguns devolvem sempre <code>false</code>.
Valores <code>nil</code> devolvem sempre <code>nil</code>.

<syntaxhighlight lang="lua">
-- Estes devolvem sempre true:
yesno('yes')
yesno('y')
yesno('true')
yesno('t')
yesno('1')
yesno(1)
yesno(true)

-- Estes devolvem sempre false:
yesno('no')
yesno('n')
yesno('false')
yesno('f')
yesno('0')
yesno(0)
yesno(false)

-- Um valor nil devolve sempre nil:
yesno(nil)
</syntaxhighlight>
Os valores da ''string'' são convertidos para letras minúsculas antes de serem correspondidas:
<syntaxhighlight lang="lua">
-- Estes devolvem sempre true:
yesno('Yes')
yesno('YES')
yesno('yEs')
yesno('Y')
yesno('tRuE')

-- Estes devolvem sempre false:
yesno('No')
yesno('NO')
yesno('nO')
yesno('N')
yesno('fALsE')
</syntaxhighlight>

Pode especificar um valor predefinido se <code>yesno</code> recebe entrada diferente da listada em cima.
Se não fornecer uma predefinição , o módulo devolverá <code>nil</code> para essas entradas.

<syntaxhighlight lang="lua">
-- Estes devolvem nil:
yesno('foo')
yesno({})
yesno(5)
yesno(function() return 'This is a function.' end)

-- Estes devolvem true:
yesno('foo', true)
yesno({}, true)
yesno(5, true)
yesno(function() return 'This is a function.' end, true)

-- Estes devolvem "bar":
yesno('foo', 'bar')
yesno({}, 'bar')
yesno(5, 'bar')
yesno(function() return 'This is a function.' end, 'bar')
</syntaxhighlight>
NOTE que UMA ''string'' em branco também funciona desta forma:
<syntaxhighlight lang="lua">
yesno('') -- Devolve nil.
yesno('', true) -- Devolve true.
yesno('', 'bar') -- Devolve "bar".
</syntaxhighlight>

Embora a ''string'' em branco geralmente seja apontada para <code>false</code> no texto wiki, ela é apontada para <code>true</code> na Lua.
Este módulo prefere o comportamento de Lua ao comportamento do texto wiki.
Se tratar a ''string'' em branco como <code>false</code> é importante para o seu módulo, terá de remover os argumentos em branco numa fase anterior do processamento.
<includeonly>{{Sandbox other||

[[Category:Modules]]
}}</includeonly><noinclude>
[[Category:Module documentation pages{{#translation:}}]]
</noinclude>
| #default=
{{#invoke:Template translation|renderTranslatedTemplate|template=Module:Yesno/doc|noshift=1|uselang={{int:lang}}}}
}}

Module:Yesno/doc/pt - Revision history

MechsploWikiSysop: 1 revision imported

mw>Aamrs: Created page with "Se tratar a ''string'' em branco como $1 é importante para o seu módulo, terá de remover os argumentos em branco numa fase anterior do processamento."