Platform.actions.findSlot

Chame como

Platform.actions.findSlot(id, bank)

Registre a dependência Platform.actions.findSlot e depois chame-a por esse nome. Uma chamada com namespace não passa self: use uma chamada com dois-pontos ou passe o objeto você mesmo.

O que faz

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).

Argumentos

Nome	Tipo	O que faz
`id`	`number`	Spell ID to locate; not validated here (callers check it with spellID first).
`bank`	`string`	Spell-book scope: spell, pet or any.

Retornos

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.

Edições

As funções auxiliares integradas são registradas em todas as edições. O que muda é a API do jogo que elas leem; quando uma está ausente, a função auxiliar recorre a uma alternativa ou retorna nil com um motivo.

Indisponível nessa edição (o motivo está na dica)
Só enquanto as alternativas da Blizzard para APIs obsoletas estiverem ativas

API do jogo
`FindSpellBookSlotBySpellID`

Como o addon a chama

Platform.actions.GetSpellRangeState

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

Dependências

call → Platform.actions.call

Código-fonte

Platform/actions.lua, linha 92. Somente leitura no jogo; Duplicar cria uma cópia editável.

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")

Voltar para Referência de funções