Referenz › Funktionsreferenz › Conditions

Conditions.spatial_stats.aggregate

Abhängigkeit

Aufruf als

Conditions.spatial_stats.aggregate(values, operation)

Erfassen Sie die Abhängigkeit Conditions.spatial_stats.aggregate und rufen Sie sie dann unter diesem Namen auf. Ein Aufruf über den Namensraum übergibt kein self: Verwenden Sie einen Doppelpunkt-Aufruf oder übergeben Sie das Objekt selbst.

Was sie bewirkt

Reduces the per-unit readings a PROXIMITY_* condition collected to one statistic: their average, minimum or maximum.

Argumente

NameTypWas sie bewirkt
valuesnumber[]Readings from the units in range.
operationstringaverage, minimum or maximum.

Rückgabewerte

1number | nilThe statistic, or nil when it cannot be computed.
2string | nilReason for nil: no-units-in-range, statistic-unavailable (a nonfinite sum) or invalid-operation.

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.

Wie das Addon sie aufruft

Quelle

Conditions/spatial_stats.lua, Zeile 107. Im Spiel schreibgeschützt; Duplizieren erstellt eine bearbeitbare Kopie.

Conditions.spatial_stats.aggregate(values, operation)
    if #values==0 then return nil,"no-units-in-range" end
    local value=values[1]
    if operation=="average" then
        local sum=0;for _,current in ipairs(values) do sum=sum+current end
        if sum==math.huge or sum==-math.huge or sum~=sum then return nil,"statistic-unavailable" end
        return sum/#values
    elseif operation=="minimum" or operation=="maximum" then
        for index=2,#values do
            if operation=="minimum" then value=math.min(value,values[index])
            else value=math.max(value,values[index]) end
        end
        return value
    end
    return nil,"invalid-operation"

Zurück zu Funktionsreferenz