Platform.role.roleValue

Chiamala come

Platform.role.roleValue(self, value)

Registra la dipendenza Platform.role.roleValue, poi chiamala con quel nome. Una chiamata con spazio dei nomi non passa self: usa una chiamata con i due punti o passa tu l'oggetto.

Cosa fa

Validates a role returned by a native API. Returns the value when it is a readable nonempty string (such as TANK, HEALER or DAMAGER); otherwise nil with "restricted-value", "role-unavailable" (nil) or "invalid-api-result".

Argomenti

Nome	Tipo	Cosa fa
`self`	`RMPlatform`	Rotation Master platform adapter (normally addon.Platform), used for its CanReadValue check.
`value`	`any`	Role value returned by the native API.

Valori restituiti

1	`string \| nil`	The role string, or nil when unavailable.
2	`string \| nil`	Reason when the role is nil.

Edizioni

Le funzioni di supporto integrate sono registrate su ogni edizione. Ciò che cambia è l'API di gioco che leggono; dove ne manca una, la funzione di supporto ripiega su un'alternativa o restituisce nil con un motivo.

Non disponibile su quell'edizione (il motivo è nel suggerimento)
Solo mentre sono attivi i ripieghi di Blizzard per le API deprecate

API di gioco
`canaccessvalue`

Valori segreti (Retail e Forever)

Su Retail e Forever il gioco fornisce agli addon valori segreti. Questa funzione di supporto controlla ciò che legge (addon.Platform:CanReadValue) e restituisce nil con un motivo come restricted-value invece di un valore segreto che non può confrontare. Considera nil come non disponibile, non come false.

Come la chiama l'addon

Platform.role.GetInspectRoleObservation
```
return roleValue(self,role)
```
Platform.role.GetTalentGroupRoleObservation
```
return roleValue(self,role)
```

Sorgente

Platform/role.lua, riga 35. Nel gioco è in sola lettura; Duplica crea una copia modificabile.

Platform.role.roleValue(self, value)

    if not self:CanReadValue(value) then return nil,'restricted-value' end
    if canaccessvalue and not canaccessvalue(value) then return nil,'restricted-value' end
    if value==nil then return nil,'role-unavailable' end
    if type(value)~='string' or value=='' then return nil,'invalid-api-result' end
    return value

Torna a Riferimento delle funzioni