Referencia › Referencia de funciones › Platform

Platform.mobinfo2.readField

dependencia

Llamar como

Platform.mobinfo2.readField(self, object, key)

Registra la dependencia Platform.mobinfo2.readField y después llámala con ese nombre. Una llamada con espacio de nombres no pasa self: usa una llamada con dos puntos o pasa el objeto tú mismo.

Qué hace

Reads object[key] in protected mode for MobInfo2 data. Returns the value (possibly nil), or nil with "restricted-value" when the object or the value is secret, "invalid-mobinfo2-data" when object is not a table, or "mobinfo2-data-error" when indexing raises an error.

Argumentos

NombreTipoQué hace
selfRMPlatformRotation Master platform adapter (normally addon.Platform), used for its CanReadValue check.
objecttableTable to index; any other type is rejected.
keyanyField name to read.

Retornos

1anyThe field value, possibly nil; nil on failure.
2string | nilReason on failure; nil on success.

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 usa 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 les entrega a los addons valores secretos. Esta función auxiliar verifica 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

Código fuente

Platform/mobinfo2.lua, línea 29. Solo lectura en el juego; Duplicar crea una copia editable.

Platform.mobinfo2.readField(self, object, key)
    if not self:CanReadValue(object) then return nil,'restricted-value' end
    if type(object)~='table' then return nil,'invalid-mobinfo2-data' end
    local ok,value=pcall(function() return object[key] end)
    if not ok then return nil,'mobinfo2-data-error' end
    if not self:CanReadValue(value) then return nil,'restricted-value' end
    return value

Volver a Referencia de funciones