Platform.items.GetItemInfoInstant

Aufruf als

addon.Platform:GetItemInfoInstant(item)

Direkt über addon verfügbar; keine Abhängigkeit nötig.

Was sie bewirkt

Normalisierte native Klassifizierungsmetadaten eines Gegenstands lesen. Der Datensatz enthält die kanonischen itemID, classID und subClassID sowie equipLoc, das nicht lokalisierte INVTYPE_*-Token der Ausrüstungsposition, wenn es lesbar und nicht leer ist; geladener Anzeigetext des Gegenstands ist nicht erforderlich. Fehlende, fehlgeschlagene, fehlerhafte oder eingeschränkte Metadaten ergeben nil mit einem Grund.

Argumente

Rückgabewerte

Editionen

Integrierte Hilfsfunktionen werden auf jeder Edition registriert. Unterschiedlich ist die Spiel-API, die sie lesen; fehlt eine, weicht die Hilfsfunktion aus oder gibt nil mit einem Grund zurück.

• Auf dieser Edition nicht verfügbar (den Grund nennt der Tooltip)
• Nur, solange Blizzards Ersatz für veraltete Funktionen aktiv ist

Spiel-API	Classic Era	TBC Anniversary	Classic Progression	Forever	Retail
C_Item.GetItemInfoInstant
GetItemInfoInstant

Geheime Werte (Retail und Forever)

Auf Retail und Forever übergibt das Spiel Addons geheime Werte. Diese Hilfsfunktion prüft, was sie liest (addon.Platform:CanReadValue), und gibt statt eines geheimen Werts, den sie nicht vergleichen kann, nil mit einem Grund wie restricted-value zurück. Behandeln Sie nil als nicht verfügbar, nicht als false.

Beispiel

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

Abhängigkeiten

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

Quelle

Platform/items.lua, Zeile 132. Im Spiel schreibgeschützt; Duplizieren erstellt eine bearbeitbare Kopie.

    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}