Platform.items.GetItemInfoInstant

Chame como

addon.Platform:GetItemInfoInstant(item)

Disponível diretamente por meio de addon; nenhuma dependência é necessária.

O que faz

Lê os metadados nativos normalizados de classificação de item. O registro contém itemID, classID e subClassID canônicos, além de equipLoc, o token não localizado INVTYPE_* do local de equipamento, quando legível e não vazio; não exige que o texto de exibição do item esteja carregado. Metadados ausentes, com falha, malformados ou restritos retornam nil com um motivo.

Argumentos

Retornos

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	Classic Era	TBC Anniversary	Classic Progression	Forever	Retail
C_Item.GetItemInfoInstant
GetItemInfoInstant

Valores secretos (Retail e Forever)

No Retail e no Forever, o jogo entrega valores secretos aos addons. Esta função auxiliar verifica o que lê (addon.Platform:CanReadValue) e retorna nil com um motivo como restricted-value em vez de um valor secreto que não consegue comparar. Trate nil como indisponível, não como false.

Exemplo

local item = addon.Platform:GetItemInfoInstant(5512) -- Healthstone
if not item then return nil end
return item.classID == 0 -- consumable

Dependências

• finite → Platform.items.finite
• identifier → Platform.items.identifier

Código-fonte

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

    local valid,reason=identifier(item)
    if not valid then return nil,reason end
    local fn=C_Item and C_Item.GetItemInfoInstant
    if type(fn)~='function' then fn=GetItemInfoInstant end
    if type(fn)~='function' then return nil,'missing-api' end
    local ok,tuple=pcall(function() return {fn(item)} end)
    if not ok then return nil,'api-error' end
    local id,class,subclass=tuple[1],tuple[6],tuple[7]
    if not self:CanReadValue(id) or not self:CanReadValue(class) or not self:CanReadValue(subclass) then return nil,'restricted-value' end
    if id==nil then return nil,'item-data-unavailable' end
    if not finite(id) or id<=0 or id%1~=0 or not finite(class) or class%1~=0
        or not finite(subclass) or subclass%1~=0 or type(item)=='number' and id~=item then return nil,'invalid-api-result' end
    -- The equip location is a non-localized INVTYPE_* token (two-hand,
    -- shield, ...). An empty or unreadable token is simply absent.
    local equipLoc=tuple[4]
    if not self:CanReadValue(equipLoc) or type(equipLoc)~='string' or equipLoc=='' then equipLoc=nil end
    return {itemID=id,classID=class,subClassID=subclass,equipLoc=equipLoc}