Platform.range.GetRangeCheckBounds

Aufruf als

addon.Platform:GetRangeCheckBounds(unit)

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

Was sie bewirkt

Das öffentliche LibRangeCheck-Intervall für eine Einheit lesen. Eine erfolgreiche Obergrenze ist inklusiv; eine positive fehlgeschlagene Untergrenze ist strikt. Eine Untergrenze von null ist synthetisch. Keine der Grenzen ist eine exakte Entfernung, und eine fehlende Obergrenze belegt nicht, dass die Einheit außerhalb jedes Radius liegt. Nicht verfügbare, fehlerhafte, eingeschränkte oder fehlgeschlagene Beobachtungen 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.

Sie liest keine Spiel-API direkt.

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 bounds = addon.Platform:GetRangeCheckBounds("target")
if not bounds then return nil end
if bounds.maximum and bounds.maximum <= 8 then return true end
if bounds.minimum and bounds.minimum >= 8 then return false end
return nil -- the interval straddles 8 yards

Quelle

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

    if not self:CanReadValue(unit) then return nil,'restricted-value' end
    if type(unit)~='string' or unit=='' then return nil,'invalid-unit' end
    if not LibStub then return nil,'missing-range-provider' end
    local loaded,provider=pcall(function() return LibStub('LibRangeCheck-3.0',true) end)
    if not loaded or not provider or type(provider.GetRange)~='function' then return nil,'missing-range-provider' end
    local ok,minimum,maximum=pcall(provider.GetRange,provider,unit)
    if not ok then return nil,'range-provider-error' end
    if not self:CanReadValue(minimum) or not self:CanReadValue(maximum) then return nil,'restricted-value' end
    for _,bound in pairs({minimum=minimum,maximum=maximum}) do
        if type(bound)~='number' or bound~=bound or bound<0 or bound==math.huge then return nil,'invalid-range-result' end
    end
    if minimum==nil and maximum==nil then return nil,'range-unavailable' end
    if minimum and maximum and minimum>maximum then return nil,'invalid-range-result' end
    return {minimum=minimum,maximum=maximum}