Core.health_forecast_conditions.readField

Llamar como

Core.health_forecast_conditions.readField(platform, object, key)

Registra la dependencia Core.health_forecast_conditions.readField 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

Reads object[key] for the health-forecast conditions without letting a restricted value, a non-table object or an index error escape.

Argumentos

Nombre	Tipo	Qué hace
`platform`	`RMPlatform`	Platform whose CanReadValue decides readability.
`object`	`any`	Table to read, such as a damage history record.
`key`	`any`	Key to read.

Retornos

1	`any`	The field's value (possibly nil), or nil on failure.
2	`string \| nil`	Reason on failure: restricted-value, invalid-health-forecast-data or health-forecast-data-error.

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

Core.health_forecast_conditions.GetConditionHealthForecast
```
current,why=readField(platform,provider,'current')
```

Código fuente

Core/health_forecast_conditions.lua, línea 35. Solo lectura en el juego; Duplicar crea una copia editable.

Core.health_forecast_conditions.readField(platform, object, key)

    if not platform:CanReadValue(object) then return nil,'restricted-value' end
    if type(object)~='table' then return nil,'invalid-health-forecast-data' end
    local ok,value=pcall(function() return object[key] end)
    if not ok then return nil,'health-forecast-data-error' end
    if not platform:CanReadValue(value) then return nil,'restricted-value' end
    return value

Volver a Referencia de funciones