调用方式
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