Core.point_conditions.GetConditionPointResource

Aufruf als

addon:GetConditionPointResource(unit, cache)

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

Was sie bewirkt

Den Punktressourcen-Selektor der ausgewählten Einheit über die Live-Zuordnung von Klasse zu Ressource und den ComboPoints-Rückgriff auflösen. Bekannte Abwesenheit ergibt false; nicht verfügbare erforderliche Identitäts- oder Selektordaten ergeben nil mit einem Grund. Vollständige Identitätsbeobachtungen werden innerhalb des Auswertungsdurchlaufs geteilt. Nur erfolgreiche Beobachtungen der Spielerklasse bleiben im aktuellen Langzeit-Cache erhalten, gebunden an die native UnitClass-Identität; die Existenz wird in jedem Durchlauf aufgefrischt. Dies wählt eine Ressource, ohne deren aktuelle oder maximale Menge zu lesen.

Argumente

Name	Typ	Was sie bewirkt
`self`	`RMAddon`	Addon-Instanz von Rotation Master (bei Doppelpunktaufrufen implizit).
`unit`	`string`	Exakte ausgewählte Einheitenkennung; nur die Spielerklasse darf den erfolgreichen Langzeit-Cache verwenden.
`cache`	`table \| nil`	Cache des Auswertungsdurchlaufs oder nil, um die Identität direkt zu beobachten. Die Ressourcenzuordnung wird bei jedem Aufruf live aufgelöst.

Rückgabewerte

1	`number \| boolean \| nil`	Expliziter nichtnegativer ganzzahliger Ressourcenselektor, false für eine bekannt abwesende Einheit oder nil, wenn erforderliche Daten nicht verfügbar sind.
2	`string \| nil`	Grund aus Richtlinie, Abfragevalidierung oder Identitäts-/Selektorverfügbarkeit für einen nil-Selektor.

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
`Enum`

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 power, reason = addon:GetConditionPointResource("player", cache)
if power == nil then return nil, reason end
if power == false then return false end
return UnitPower("player", power) >= 4

Abhängigkeiten

playerClassCacheKey (builtin:Core/point_conditions.lua:playerClassCacheKey)
pointIdentity → Core.point_conditions.pointIdentity

Quelle

Core/point_conditions.lua, Zeile 58. Im Spiel schreibgeschützt; Duplizieren erstellt eine bearbeitbare Kopie.

Core.point_conditions.GetConditionPointResource(self, unit, cache)

    local platform=self.Platform
    if platform:GetCombatDataPolicy()~='probe' then return nil,'unsupported-policy' end
    if not platform:CanReadValue(unit) then return nil,'restricted-value' end
    if type(unit)~='string' or unit=='' then return nil,'invalid-unit' end
    local record,reason=addon.Functions.cache.getCached(cache,pointIdentity,self,unit,playerClassCacheKey)
    if not record then return nil,reason end
    if not record.exists then return false end
    local points=self.points
    if not platform:CanReadValue(points) then return nil,'restricted-value' end
    if type(points)~='table' then return nil,'invalid-point-resource-map' end
    local ok,selected=pcall(function() return points[record.class] end)
    if not ok then return nil,'api-error' end
    if not platform:CanReadValue(selected) then return nil,'restricted-value' end
    if selected==nil or selected==false then
        local enum=Enum
        if not platform:CanReadValue(enum) then return nil,'restricted-value' end
        if type(enum)~='table' then return nil,'point-resource-unavailable' end
        local typesOK,types=pcall(function() return enum.PowerType end)
        if not typesOK then return nil,'api-error' end
        if not platform:CanReadValue(types) then return nil,'restricted-value' end
        if type(types)~='table' then return nil,'point-resource-unavailable' end
        local fallbackOK,fallback=pcall(function() return types.ComboPoints end)
        if not fallbackOK then return nil,'api-error' end
        selected=fallback
        if not platform:CanReadValue(selected) then return nil,'restricted-value' end
    end
    if selected==nil then return nil,'point-resource-unavailable' end
    if type(selected)~='number' or selected~=selected or selected<0 or selected==math.huge or selected%1~=0 then return nil,'invalid-point-resource' end
    return selected

Zurück zu Funktionsreferenz