Conditions.equipment.subclassName

调用方式

Conditions.equipment.subclassName(id)

记录依赖项 Conditions.equipment.subclassName，然后按该名称调用。带命名空间的调用不会传入 self：请使用冒号调用，或自行传入该对象。

作用

Names a weapon subclass for WEAPON_TYPE descriptions, using the client's GetItemSubClassInfo when it returns a readable name, else the addon's built-in name, else "weapon type N".

参数

返回值

版本

内置辅助函数在每个版本上都会注册。不同的是它们读取的游戏 API；某个 API 缺失时，辅助函数会改用后备方案，或返回 nil 并附上原因。

• 该版本不可用（原因见提示）
• 仅在暴雪的弃用兼容层开启时

游戏 API	经典旧世	TBC 周年版	经典进阶服	永久服	正式服
C_Item.GetItemSubClassInfo
GetItemSubClassInfo

秘密值（正式服和永久服）

在正式服和永久服上，游戏交给插件的是秘密值。此辅助函数会检查它读取的内容（addon.Platform:CanReadValue），遇到无法比较的秘密值时返回 nil 并附上原因（例如 restricted-value），而不是返回该秘密值。请将 nil 视为不可用，而不是假。

插件如何调用它

• 武器类型 (print)

  if value.subclass ~= nil then what = subclassName(value.subclass) else what = kinds[value.kind] end

依赖项

• WEAPON_CLASS (builtin:Conditions/equipment.lua:WEAPON_CLASS)
• subclassNames (builtin:Conditions/equipment.lua:subclassNames)

源码

Conditions/equipment.lua，第 103 行。在游戏中为只读；“复制”会生成一份可编辑的副本。

    local fn = C_Item and C_Item.GetItemSubClassInfo or GetItemSubClassInfo
    if type(fn) == "function" then
        local ok, name = pcall(fn, WEAPON_CLASS, id)
        if ok and addon.Platform:CanReadValue(name) and type(name) == "string" and name ~= "" then return name end
    end
    return subclassNames[id] and L[subclassNames[id]] or string.format(L["weapon type %d"], id)