Platform.actions.findSlot

呼叫方式

Platform.actions.findSlot(id, bank)

記錄相依項目 Platform.actions.findSlot，然後以該名稱呼叫。含命名空間的呼叫不會傳入 self：請使用冒號呼叫，或自行傳入該物件。

作用

Finds the spell-book slot of a spell with FindSpellBookSlotBySpellID. bank "pet" searches the pet book, "any" searches the player book and then the pet book, and any other value searches the player book only. Returns the slot and its book type, or nil, nil and a reason: spell-not-in-book, invalid-api-result, or a reason from call (missing-api, api-error, restricted-value).

參數

名稱	類型	作用
`id`	`number`	Spell ID to locate; not validated here (callers check it with spellID first).
`bank`	`string`	Spell-book scope: spell, pet or any.

傳回值

1	`number \| nil`	Positive integer spell-book slot, or nil when not found or unavailable.
2	`string \| nil`	Book type for that slot: BOOKTYPE_PET (pet) or BOOKTYPE_SPELL (spell); nil on failure.
3	`string \| nil`	Reason when the slot is nil.

版本

內建輔助函式在每個版本上都會註冊。不同的是它們讀取的遊戲 API；某個 API 不存在時，輔助函式會改用備用方式，或傳回 nil 並附上原因。

該版本無法使用（原因請見提示）
僅在暴雪的棄用相容層開啟時

遊戲 API
`FindSpellBookSlotBySpellID`

插件如何呼叫它

Platform.actions.GetSpellRangeState

if not slot then slot,book,slotReason=findSlot(id,bank) end

相依項目

call → Platform.actions.call

原始碼

Platform/actions.lua，第 92 行。在遊戲中為唯讀；「複製」會產生一份可編輯的複本。

Platform.actions.findSlot(id, bank)

    local pet=bank=="pet"
    local slot,reason=call(FindSpellBookSlotBySpellID,id,pet)
    if reason then return nil,nil,reason end
    if slot==nil and bank=="any" then
        pet=true;slot,reason=call(FindSpellBookSlotBySpellID,id,true)
        if reason then return nil,nil,reason end
    end
    if slot==nil then return nil,nil,"spell-not-in-book" end
    if type(slot)~="number" or slot<1 or slot==math.huge or slot%1~=0 then return nil,nil,"invalid-api-result" end
    return slot,pet and (BOOKTYPE_PET or "pet") or (BOOKTYPE_SPELL or "spell")

返回函式參考