Yuki : 1 version importée : Infobox

2023-11-15T07:11:26Z

1 version importée : Infobox

← Version précédente

Version du 15 novembre 2023 à 03:11

wikipedia>Escargot bleu le 12 juillet 2023 à 14:40

2023-07-12T14:40:36Z

Nouvelle page

<includeonly>{{Shared Template Warning|Module:Yesno|Module:Yesno}}</includeonly>
Ce module propose une fonction cohérente pour transformer des valeur ou chaine en booléen.

== Utilisation ==
Le wikicode ne permet pas de saisir directement des valeur booléenne, seulement des chaine type « oui » ou « non ». Ce module les évalue et détermine une valeur booléenne <syntaxhighlight lang="lua" inline>true</syntaxhighlight> ou <syntaxhighlight lang="lua" inline>false</syntaxhighlight> que lua pourra utiliser. Il retourne <syntaxhighlight lang="lua" inline>nil</syntaxhighlight> en l’absence de paramètre, pour permettre la distinction entre <code>nil</code> et <code>false</code>. Lorsque ce paramètre a une valeur imprévue, le module retourne la valeur par défaut ou <code>nil</code>.

== Syntaxe ==
<syntaxhighlight lang="lua">yesno(valeur, défaut, défautVide)</syntaxhighlight>

* <code>valeur</code> – est la valeur à tester.
* <code>défaut</code> – valeur par défaut pour les valeurs qui ne sont ni assimilé à des booléens ni <code>nil</code>.
* <code>défautVide</code> – si ce paramètre n'est pas <code>nil</code> ce sera la valeur par défaut pour les chaines vides ou uniquement composées d'espaces, sauts de ligne…

== Exemples ==
Il faut commencer par charger le module. Il ne peut être appelé que depuis un autre module Lua, il ne peut pas être appelé directement par un modèle.
<syntaxhighlight lang="lua">
local yesno = require('Module:Yesno')
</syntaxhighlight>

Certaines valeurs retournent toujours <code>true</code>, d'autres valeurs retournent toujours <code>false</code>. La valeur <code>nil</code> retourne toujours <code>nil</code>.

<syntaxhighlight lang="lua">
-- Ces valeurs retournent toujours true :
yesno('oui')
yesno('yes')
yesno('y')
yesno('true')
yesno('1')
yesno(1)
yesno(true)

-- Ces valeurs retournent toujours false :
yesno('non')
yesno('no')
yesno('n')
yesno('false')
yesno('0')
yesno(0)
yesno(false)

-- Une valeur nil retourne nil :
yesno(nil)
</syntaxhighlight>

Les chaines sont converties en minuscules avant d'être évaluées :

<syntaxhighlight lang="lua">
-- Ces valeurs retournent toujours true :
yesno('Oui')
yesno('OUI')
yesno('oUi')
yesno('tRuE')

-- Ces valeurs retournent toujours false :
yesno('Non')
yesno('NON')
yesno('nOn')
yesno('fALsE')
</syntaxhighlight>

Une valeur par défaut peut être spécifiée pour les valeurs autres que celle listée ci-dessus. Si aucune valeur par défaut n'est fournie le module retourne <code>nil</code> pour ces valeurs.
<syntaxhighlight lang="lua">
-- Ces valeurs retournent nil :
yesno('foo')
yesno({})
yesno(5)
yesno(function() return 'Ceci est une fonction.' end)

-- Ces valeurs retournent true :
yesno('foo', true)
yesno({}, true)
yesno(5, true)
yesno(function() return 'This is a function.' end, true)

-- Ces valeurs retournent "bar" :
yesno('foo', 'bar')
yesno({}, 'bar')
yesno(5, 'bar')
yesno(function() return 'This is a function.' end, 'bar')
</syntaxhighlight>

Une chaine vide est évaluée à la valeur du troisième paramètre s'il est défini, sinon à la valeur par défaut.
<syntaxhighlight lang="lua">
yesno('') -- Retourne nil.
yesno('', true) -- Retourne true.
yesno('', true, nil) -- Retourne true.
yesno('', true, false) -- Retourne false.
yesno('', 'foo', 'bar') -- Retourne 'bar'.
</syntaxhighlight>

Attention, cette dernière fonctionnalité est différente du module présent sur [[:en:]] qui n'a qu'une valeur par défaut.

== Voir aussi ==
* [[Aide:Paramètre booléen]]
* {{m|Oui non}}

{{Projet Scribunto}}

<includeonly>
[[Catégorie:Méta-module]]
[[Catégorie:Module appelé par un autre module]]
</includeonly>

Module:Yesno/Documentation - Historique des versions

Yuki : 1 version importée : Infobox

wikipedia>Escargot bleu le 12 juillet 2023 à 14:40

Yuki : 1 version importée : Infobox