模も組ぐみ:Yesno

模かたぎ块文档[查看] [编辑] [历史] [清きよし除じょ缓存]

本ほん模も块提供用きょうよう于处理り布ぬの尔值或ある形かたち如布尔值的てき字じ符ふ串くし输入的てき一致いっち接せっ口こう。Lua允まこと许布尔值true和わfalse，wiki代だい码则只ただ能のう用よう像ぞうyes、no这样的てき词语来き表おもて达布尔值。本ほん模も块处理り这些字じ符ふ串くし并将其转化か为布尔值，以供Lua处理。对于nil值依旧きゅう返かえし回かいnil，以允许区分くぶんnil和わfalse。本ほん模も块同样接受せつじゅ其他的てきLua结构输入，如布尔值、数字すうじ、表ひょう、函数かんすう。如果传入的てき值不能ふのう被ひ理解りかい为布尔值或あるnil，可か以指定してい一个要返回的默认值。

语法

yesno(value, default)

value是ぜ需要じゅよう测试的てき值。布ぬの尔值输入或ある类似于布尔值的てき输入（见下方かた）总是视为true或あるfalse，nil总是视为nil。其他的てき值一律いちりつ取とdefault。

用法ようほう

首くび先さき加か载模块。注意ちゅうい只ただ能のう由よし其他Lua模も块加载，而不是ぜ一般いっぱん的てきwiki页面。对于一般いっぱん的てきwiki页面可か以使用しよう{{yesno}}。

local yesno = require('Module:Yesno')

一些输入总是返回true，一些则是返回false。nil值总是ぜ返かえし回かいnil。

-- 这些总是返かえし回かいtrue：
yesno('yes')
yesno('y')
yesno('true')
yesno('1')
yesno(1)
yesno(true)
yesno('是ぜ')
yesno('开')
yesno('開ひらく')

-- 这些总是返かえし回かいfalse：
yesno('no')
yesno('n')
yesno('false')
yesno('0')
yesno(0)
yesno(false)
yesno('否いな')
yesno('关')
yesno('關せき')

-- nil值总是ぜ返かえし回かいnil：
yesno(nil)

一些值在匹配之前转化为小写：

-- 这些总是返かえし回かいtrue：
yesno('Yes')
yesno('YES')
yesno('yEs')
yesno('Y')
yesno('tRuE')

-- 这些总是返かえし回かいfalse：
yesno('No')
yesno('NO')
yesno('nO')
yesno('N')
yesno('fALsE')

未定みてい义值

如果yesno收おさむ到いた一个上面没有列出的输入值，你可以指定してい一いち个默认值。如果不ふ提供ていきょう默だま认值，则这些输入会にゅうかい返かえし回かいnil。

-- 这些会かい返かえし回かいnil：
yesno('foo')
yesno({})
yesno(5)
yesno(function() return '这是函数かんすう' end)

-- 这些会かい返かえし回かいtrue：
yesno('foo', true)
yesno({}, true)
yesno(5, true)
yesno(function() return '这是函数かんすう' end, true)

-- 这些返かえし回かい字じ符ふ串くし"bar"：
yesno('foo', 'bar')
yesno({}, 'bar')
yesno(5, 'bar')
yesno(function() return '这是函数かんすう' end, 'bar')

注意ちゅうい空白くうはく字じ符ふ串くし也是如此：

yesno('')        -- Returns nil.
yesno('', true)  -- Returns true.
yesno('', 'bar') -- Returns "bar".

尽つき管かん空そら字じ符ふ串くし在ざい维基文ぶん本中ほんなか的てき计算结果通常つうじょう为false，但ただし在ざいLua中ちゅう的てき仍是视为true。该模块倾向こう于Lua行ぎょう为而不ふ是ぜ维基文ぶん本ほん行ぎょう为。如果将はた空白くうはく字じ符ふ串くし视为false 对您的てき模も块很重要じゅうよう，则您需要じゅよう在ざい处理的てき早期そうき阶段删除空白くうはく参さん数すう，例れい如Module:Arguments就会默だま认移除じょ空白くうはく参さん数すう。

处理nil

根ね据すえ定てい义，

yesno(nil)         -- Returns nil.
yesno('foo')       -- Returns nil.
yesno(nil, true)   -- Returns nil.
yesno(nil, false)  -- Returns nil.
yesno('foo', true) -- Returns true.

要よう返かえし回かい仅有true/false的てき二に元げん值，使用しよう这样的てき代だい码：

myvariable = yesno(value) or false -- 若わかvalue为nil，则结果はて为false。
myvariable = yesno(value) or true  -- 若わかvalue为nil，则结果はて为true。
myvariable = yesno('foo') or false  -- 未知みち字じ符ふ串くし返かえし回かいnil，结果为false。
myvariable = yesno('foo', true) or false  -- 应用默だま认值（此处为true），结果为true。

-- Function allowing for consistent treatment of boolean-like wikitext input.
-- It works similarly to the template {{yesno}}.

return function (val, default)
	-- If your wiki uses non-ascii characters for any of "yes", "no", etc., you
	-- should replace "val:lower()" with "mw.ustring.lower(val)" in the
	-- following line.
	val = type(val) == 'string' and val:lower() or val
	if val == nil then
		return nil
	elseif val == true 
		or val == 'yes'
		or val == 'y'
		or val == 'true'
		or val == 't'
		or val == 'on'
		or val == '是ぜ'
		or val == '开'
		or val == '開ひらく'
		or tonumber(val) == 1
	then
		return true
	elseif val == false
		or val == 'no'
		or val == 'n'
		or val == 'false'
		or val == 'f'
		or val == 'off'
		or val == '否いな'
		or val == '关'
		or val == '關せき'
		or tonumber(val) == 0
	then
		return false
	else
		return default
	end
end