Core.threat_count_conditions.readField

Llamar como

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

Registra la dependencia Core.threat_count_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 threat-count conditions without letting a restricted value, a non-table object or an index error escape.

Argumentos

Retornos

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.threat_count_conditions.GetConditionThreatCount

  local snapshot,why=readField(platform,self,'unitsInRange')

Código fuente

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

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