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)