模組:Yesno/doc

此頁面為 Module:Yesno 的說明文件

本模塊提供用於處理布爾值或形如布爾值的字符串輸入的一致接口。Lua允許布爾值truefalse,wiki代碼則只能用像yes、no這樣的詞語來表達布爾值。本模塊處理這些字符串並將其轉化為布爾值,以供Lua處理。對於nil值依舊返回nil,以允許區分nilfalse。本模塊同樣接受其他的Lua結構輸入,如布爾值、數字、表、函數。如果傳入的值不能被理解為布爾值或nil,可以指定一個要返回的默認值。

語法

yesno(value, default)

value是需要測試的值。布爾值輸入或類似於布爾值的輸入(見下方)總是視為truefalsenil總是視為nil。其他的值一律取default

用法

首先加載模塊。注意只能由其他Lua模塊加載,而不是一般的wiki頁面。對於一般的wiki頁面可以使用{{yesno}}。

local yesno = require('Module:Yesno')

一些輸入總是返回true,一些則是返回falsenil值總是返回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。