Llamar como
Platform.runes.numberField(self, value, missing)
Registra la dependencia Platform.runes.numberField y luego llámala con ese nombre. Una llamada con espacio de nombres no pasa self: usa una llamada con dos puntos o pasa tú mismo el objeto.
Qué hace
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".
Argumentos
| Nombre | Tipo | Qué hace |
|---|---|---|
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. |
Retornos
| 1 | number | nil | The finite value, or nil when unavailable. |
|---|---|---|
| 2 | string | nil | Reason when the value is nil. |
Ediciones
Las funciones auxiliares integradas se registran en todas las ediciones. Lo que cambia es la API del juego que leen; donde falta alguna, la función auxiliar recurre a una alternativa o devuelve nil con un motivo.
- No disponible en esa edición (el motivo aparece en la información emergente)
- Solo mientras estén activas las alternativas de Blizzard para API obsoletas
| API del juego |  |  |  |  |  |
|---|---|---|---|---|---|
canaccessvalue | | | | | |
Valores secretos (Retail y Forever)
En Retail y Forever, el juego entrega a los addons valores secretos. Esta función auxiliar comprueba lo que lee (addon.Platform:CanReadValue) y, en lugar de un secreto que no puede comparar, devuelve nil con un motivo como restricted-value. Trata nil como no disponible, no como falso.
Cómo la llama el addon
Platform.runes.GetRuneCooldownObservationrecord.start,record.startReason=numberField(self,tuple[1],'rune-start-unavailable')Platform.runes.GetRuneEvaluationTimereturn numberField(self,value,'rune-time-unavailable')Platform.runes.GetRuneTypeObservationlocal runeType,why=numberField(self,value,'rune-type-unavailable')
Dependencias
finite→Platform.runes.finite
Código fuente
Platform/runes.lua, línea 36. Solo lectura en el juego; Duplicar crea una copia editable.
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