Aufruf als
Core.threat_count_conditions.readField(platform, object, key)
Erfassen Sie die Abhängigkeit Core.threat_count_conditions.readField und rufen Sie sie dann unter diesem Namen auf. Ein Aufruf über den Namensraum übergibt kein self: Verwenden Sie einen Doppelpunkt-Aufruf oder übergeben Sie das Objekt selbst.
Was sie bewirkt
Reads object[key] for the threat-count conditions without letting a restricted value, a non-table object or an index error escape.
Argumente
| Name | Typ | Was sie bewirkt |
|---|---|---|
platform | RMPlatform | Platform whose CanReadValue decides readability. |
object | any | Table to read, such as the addon or a unit snapshot entry. |
key | any | Key to read, such as "unitsInRange". |
Rückgabewerte
| 1 | any | The field's value (possibly nil), or nil on failure. |
|---|---|---|
| 2 | string | nil | Reason on failure: restricted-value, invalid-unit-snapshot or unit-snapshot-read-error. |
Editionen
Integrierte Hilfsfunktionen werden auf jeder Edition registriert. Unterschiedlich ist die Spiel-API, die sie lesen; fehlt eine, weicht die Hilfsfunktion aus oder gibt nil mit einem Grund zurück.
Sie liest keine Spiel-API direkt.
Geheime Werte (Retail und Forever)
Auf Retail und Forever übergibt das Spiel Addons geheime Werte. Diese Hilfsfunktion prüft, was sie liest (addon.Platform:CanReadValue), und gibt statt eines geheimen Werts, den sie nicht vergleichen kann, nil mit einem Grund wie restricted-value zurück. Behandeln Sie nil als nicht verfügbar, nicht als false.
Wie das Addon sie aufruft
Core.threat_count_conditions.GetConditionThreatCountlocal snapshot,why=readField(platform,self,'unitsInRange')
Quelle
Core/threat_count_conditions.lua, Zeile 33. Im Spiel schreibgeschützt; Duplizieren erstellt eine bearbeitbare Kopie.
Core.threat_count_conditions.readField(platform, object, key)
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