呼叫方式
Functions.presentation.compareString(operator, left, right, primary)
將它記錄為名為 Functions.presentation.compareString 的相依項目（接受自動完成即可完成此步驟），然後以該名稱呼叫。
作用
當運算子有否定形式時，使用命名布林備選項格式化比較措辭。primary 標記會將肯定形式標為主要措辭。肯定運算子標籤使用擷取的運算子對應；否定標籤與可為空分派保留其即時的插件 API。
參數
| 名稱 | 類型 | 作用 |
|---|---|---|
operator | string | nil | RM 比較運算子識別碼；缺少的標籤使用運算子預留位置。 |
left | string | number | 顯示在比較措辭之前的文字或數字。 |
right | string | number | 顯示在比較措辭之後的文字或數字。 |
primary | boolean | nil | 將肯定措辭標記為主要的命名備選項。 |
傳回值
| 1 | string | 保留命名布林備選標記的比較文字。 |
|---|
版本
內建輔助函式在每個版本上都會註冊。不同的是它們讀取的遊戲 API；某個 API 不存在時，輔助函式會改用備用方式，或傳回 nil 並附上原因。
它不會直接讀取任何遊戲 API。
插件如何呼叫它
- 任意法術充能 (print)
Functions.presentation.compareString(value.operator, string.format(L["number of charges on %s"], Functions.presentation.nullable(link, L["<spell>"])), Functions.presentation.nullable(value.value))) - 任意法術冷卻 (print)
Functions.presentation.compareString(value.operator, string.format(L["cooldown on %s"], Functions.presentation.nullable(link, L["<spell>"])), - 任意法術充能時間 (print)
Functions.presentation.compareString(value.operator, string.format(L["recharge time on %s"], Functions.presentation.nullable(link, L["<spell>"])), - 首領模組首領戰階段 (print)
return Functions.presentation.compareString(value.operator, L["the boss-mod encounter stage"], Functions.presentation.nullable(value.value)) - 首領模組計時條 (print)
return Functions.presentation.compareString(value.operator, string.format(L["the boss-mod timer for %s"], spell), - 施法進度 (print)
return Functions.presentation.compareString(value.operator, string.format(L["%s cast progress"], Functions.presentation.nullable(addon.unitsPossessive[value.unit], L["<unit>"])), Functions.presentation.nullable(v) .. "%") - 施法剩餘時間 (print)
return Functions.presentation.compareString(value.operator, - 引導進度 (print)
return Functions.presentation.compareString(value.operator, string.format(L["%s channel progress"], Functions.presentation.nullable(addon.unitsPossessive[value.unit], L["<unit>"])), Functions.presentation.nullable(v) .. "%")
以及另外 43 處: 引導剩餘時間 (print), 隊伍中的職業 (print), 距離內計數 (print), 日月蝕 (print), 隊伍計數 (print), 生命力 (print), 生命力百分比 (print), 物品冷卻 (print), 傳奇+鑰石等級 (print), 等級 (print), 失去控制封鎖 (print), 失去控制類型 (print), 法力 (print), 法力百分比 (print), 團隊標記數量 (print), 寵物法術充能 (print), 寵物法術冷卻 (print), 寵物法術充能時間 (print), 點數 (print), 能量 (print), 能量百分比 (print), 範圍內的盟友 (print), 有抗性 (print), 符文 (print), 符文冷卻 (print), 等級 (print), 法術充能 (print), 法術冷卻 (print), 法術充能時間 (print), Stagger (print), 角色屬性 (print), 武器攻擊間隔 (print), 武器攻擊間隔剩餘時間 (print), 天賦 (print), 天賦樹點數 (print), 威脅值計數 (print), 戰鬥開始後的時間 (print), 圖騰剩餘時間 (print), 特定圖騰剩餘時間 (print), 距離生命力達到所需時間 (print), 距離生命力百分比達到所需時間 (print), 武器附魔剩餘時間 (print), 武器附魔層數 (print)
相依項目
operators(builtin:Functions/presentation.lua:operators)
原始碼
Functions/presentation.lua，第 73 行。在遊戲中為唯讀；「複製」會產生一份可編輯的複本。
Functions.presentation.compareString(operator, left, right, primary)
local positive=addon.nullable(operators[operator], L["<operator>"])
local negative=(addon.negatedOperators or {})[operator]
local predicate=negative and ('{{'..(primary and '!' or '')..positive..'|'..negative..'}}') or positive
return left .. " " .. predicate .. " " .. right