Referencia › Referencia de funciones › Platform

Platform.actions.spellID

dependencia

Llamar como

Platform.actions.spellID(id)

Registra la dependencia Platform.actions.spellID 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

Validates a spell ID argument. Returns true for a readable positive finite integer; otherwise nil with "restricted-value" for a secret value or "invalid-spell" for anything else (including spell names).

Argumentos

NombreTipoQué hace
idanyValue to validate as a spell ID.

Retornos

1boolean | nilTrue when id is a valid spell ID; nil otherwise.
2string | nilrestricted-value or invalid-spell when invalid.

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

Dependencias

Código fuente

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

Platform.actions.spellID(id)
    if not platform:CanReadValue(id) then return nil,"restricted-value" end
    if type(id)~="number" or id<1 or id==math.huge or id%1~=0 then return nil,"invalid-spell" end
    return true

Volver a Referencia de funciones