Referenz › Funktionsreferenz › Core

Core.threat_count_conditions.readField

Abhängigkeit

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

NameTypWas sie bewirkt
platformRMPlatformPlatform whose CanReadValue decides readability.
objectanyTable to read, such as the addon or a unit snapshot entry.
keyanyKey to read, such as "unitsInRange".

Rückgabewerte

1anyThe field's value (possibly nil), or nil on failure.
2string | nilReason 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

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

Zurück zu Funktionsreferenz