Riferimento › Riferimento delle funzioni › Platform

Platform.loss_of_control.GetLossOfControlCount

pubblica

Chiamala come

addon.Platform:GetLossOfControlCount()

Disponibile direttamente tramite addon; non serve alcuna dipendenza.

Cosa fa

Legge il conteggio documentato delle perdite di controllo attive con una chiamata con punto protetta senza argomenti. Richiede un intero leggibile, finito e non negativo. Zero è una scansione vuota completa e non richiede un'API per le righe. RM limita una scansione a 256 righe e oltre questo budget restituisce non disponibile; non si tratta di un massimo nativo dichiarato. Osservazioni richieste mancanti, fallite, soggette a restrizioni o malformate restano non disponibili.

Argomenti

NomeTipoCosa fa
selfRMPlatformAdattatore di piattaforma di Rotation Master (implicito nelle chiamate con due punti).

Valori restituiti

1number | nilConteggio attivo noto, da zero fino al budget di scansione di RM, oppure nil se non disponibile.
2string | nilMotivo di policy di combattimento, di funzionalità, di osservazione o di budget di scansione quando il conteggio è nil.

Edizioni

Le funzioni di supporto integrate sono registrate su ogni edizione. Ciò che cambia è l'API di gioco che leggono; dove ne manca una, la funzione di supporto ripiega su un'alternativa o restituisce nil con un motivo.

  • Non disponibile su quell'edizione (il motivo è nel suggerimento)
  • Solo mentre sono attivi i ripieghi di Blizzard per le API deprecate
API di giocoClassic EraTBC AnniversaryClassic progressionForeverRetail
C_LossOfControlClassic EraTBC AnniversaryClassic progressionForeverRetail
canaccessvalueClassic EraTBC AnniversaryClassic progressionForeverRetail

Valori segreti (Retail e Forever)

Su Retail e Forever il gioco fornisce agli addon valori segreti. Questa funzione di supporto controlla ciò che legge (addon.Platform:CanReadValue) e restituisce nil con un motivo come restricted-value invece di un valore segreto che non può confrontare. Considera nil come non disponibile, non come false.

Esempio

local count = addon.Platform:GetLossOfControlCount()
if count == nil then return nil end
return count > 0

Sorgente

Platform/loss_of_control.lua, riga 16. Nel gioco è in sola lettura; Duplica crea una copia modificabile.

Platform.loss_of_control.GetLossOfControlCount(self)
    local policy=self:GetCombatDataPolicy()
    if policy~='probe' and policy~='restricted' then return nil,'unsupported-policy' end
    local namespace=C_LossOfControl
    if not self:CanReadValue(namespace) then return nil,'restricted-value' end
    if type(namespace)~='table' then return nil,'missing-api' end
    local methodOk,method=pcall(function() return namespace.GetActiveLossOfControlDataCount end)
    if not methodOk then return nil,'api-error' end
    if not self:CanReadValue(method) then return nil,'restricted-value' end
    if type(method)~='function' then return nil,'missing-api' end
    local ok,count=pcall(method)
    if not ok then return nil,'api-error' end
    if not self:CanReadValue(count) then return nil,'restricted-value' end
    if canaccessvalue and not canaccessvalue(count) then return nil,'restricted-value' end
    if count==nil then return nil,'loss-of-control-count-unavailable' end
    if type(count)~='number' or count~=count or count==math.huge or count==-math.huge or count<0 or count%1~=0 then return nil,'invalid-api-result' end
    if count>256 then return nil,'loss-of-control-budget-exceeded' end
    return count

Torna a Riferimento delle funzioni