Platform.runes.numberField

Chiamala come

Platform.runes.numberField(self, value, missing)

Registra la dipendenza Platform.runes.numberField, poi chiamala con quel nome. Una chiamata con spazio dei nomi non passa self: usa una chiamata con i due punti o passa tu l'oggetto.

Cosa fa

Normalizes one numeric field of a native result. Returns the value when it is a readable finite number (sign and fractions kept); otherwise nil with "restricted-value", the caller-supplied missing reason when the value is nil, or "invalid-api-result".

Argomenti

Nome	Tipo	Cosa fa
`self`	`RMPlatform`	Rotation Master platform adapter (normally addon.Platform), used for its CanReadValue check.
`value`	`any`	Field value from the native result.
`missing`	`string`	Reason to return when value is nil, such as rune-start-unavailable.

Valori restituiti

1	`number \| nil`	The finite value, or nil when unavailable.
2	`string \| nil`	Reason when the value is 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 gioco
`canaccessvalue`

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.

Come la chiama l'addon

Platform.runes.GetRuneCooldownObservation

record.start,record.startReason=numberField(self,tuple[1],'rune-start-unavailable')

Platform.runes.GetRuneEvaluationTime

return numberField(self,value,'rune-time-unavailable')

Platform.runes.GetRuneTypeObservation

local runeType,why=numberField(self,value,'rune-type-unavailable')

Dipendenze

finite → Platform.runes.finite

Sorgente

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

Platform.runes.numberField(self, value, missing)

    if not self:CanReadValue(value) then return nil,'restricted-value' end
    if canaccessvalue and not canaccessvalue(value) then return nil,'restricted-value' end
    if value==nil then return nil,missing end
    if not finite(value) then return nil,'invalid-api-result' end
    return value

Torna a Riferimento delle funzioni