Llamar como
Conditions.weapon.numericObservation(value)
Registra la dependencia Conditions.weapon.numericObservation 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
Accepts a readable, nonnegative, finite number from a weapon observation and returns it unchanged; anything else becomes nil with a reason.
Argumentos
| Nombre | Tipo | Qué hace |
|---|---|---|
value | any | Observed value, such as an expiration time or swing speed. |
Retornos
| 1 | number | nil | The value, or nil when it is not usable. |
|---|---|---|
| 2 | string | nil | Reason for nil: restricted-value or invalid-weapon-observation. |
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 lee directamente ninguna API del juego.
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
- Tiempo restante del encantamiento de arma (evaluate)
local duration,why=numericObservation(expires) - Cargas del encantamiento de arma (evaluate)
local count,why=numericObservation(charges) Conditions.weapon.swingSpeedreturn numericObservation(speed)
Código fuente
Conditions/weapon.lua, línea 81. Solo lectura en el juego; Duplicar crea una copia editable.
Conditions.weapon.numericObservation(value)
if not addon.Platform:CanReadValue(value) then return nil,"restricted-value" end
if type(value)~="number" or value~=value or value<0 or value==math.huge then return nil,"invalid-weapon-observation" end
return value