呼叫方式
Functions.presentation.nullable_value(value, array, default)
將它記錄為名為 Functions.presentation.nullable_value 的相依項目（接受自動完成即可完成此步驟），然後以該名稱呼叫。
也接受舊命名空間 utils 下的名稱。
作用
查詢表格中的鍵用於顯示，保留非 nil 的結果；無效的表格、缺少的鍵與 nil 鍵會使用可為空預留位置文字。
參數
| 名稱 | 類型 | 作用 |
|---|---|---|
value | any | 要查詢的鍵。 |
array | table | nil | 顯示查詢表。 |
default | string | nil | 缺少值的顯示文字；省略時使用在地化的值預留位置。 |
傳回值
| 1 | any | 原始的非 nil 查詢結果，或一個帶顏色的預留位置字串。 |
|---|
版本
內建輔助函式在每個版本上都會註冊。不同的是它們讀取的遊戲 API；某個 API 不存在時，輔助函式會改用備用方式，或傳回 nil 並附上原因。
它不會直接讀取任何遊戲 API。
插件如何呼叫它
- 擴充角色屬性 (print)
stat = Functions.presentation.nullable_value(value.stat, ecs_state.stats, L["<stat>"]), - 擴充角色屬性百分比 (print)
stat = Functions.presentation.nullable_value(value.stat, ecs_state.percentages, L["<stat>"]), - 角色屬性 (print)
Functions.presentation.nullable_value(value.stat, addon.stats, L["<stat>"])), Functions.presentation.nullable(value.value))
相依項目
color(builtin:utils.lua:color)
原始碼
Functions/presentation.lua，第 40 行。在遊戲中為唯讀；「複製」會產生一份可編輯的複本。
Functions.presentation.nullable_value(value, array, default)
if value == nil or array == nil or type(array) ~= "table" then
if default ~= nil then
return color.RED .. default .. color.RESET
else
return color.RED .. L["<value>"] .. color.RESET
end
end
return addon.nullable(array[value], default)