Platform.items.identifier

Aufruf als

Platform.items.identifier(item)

Erfassen Sie die Abhängigkeit Platform.items.identifier 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

Validates an item argument. Accepts a positive finite integer item ID or a nonempty string (an item name or link) of up to 1024 characters. Returns true, or nil with "restricted-value" for a secret value or "invalid-item" for anything else.

Argumente

Name	Typ	Was sie bewirkt
`item`	`any`	Item ID, name or link to validate.

Rückgabewerte

1	`boolean \| nil`	True when item is acceptable; nil otherwise.
2	`string \| nil`	restricted-value or invalid-item when rejected.

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

Platform.items.GetItemInfoInstant
```
local valid,reason=identifier(item)
```

Abhängigkeiten

platform (builtin:Platform/items.lua:platform)

Quelle

Platform/items.lua, Zeile 20. Im Spiel schreibgeschützt; Duplizieren erstellt eine bearbeitbare Kopie.

Platform.items.identifier(item)

    if not platform:CanReadValue(item) then return nil,"restricted-value" end
    if type(item)=="number" and item>0 and item<math.huge and item%1==0 then return true end
    if type(item)=="string" and #item>0 and #item<=1024 then return true end
    return nil,"invalid-item"

Zurück zu Funktionsreferenz