Real Dokumentation

Syntax

json.getPath(object: table, path: string | table, defaultValue?: any): any | nil

Aliase json.getpath

Argumente

Name	Typ	Beschreibung
`object`	`table`	Objekt-, Tabellen- oder Zeichnungswert zum Überprüfen oder Ändern.
`path`	`string \| table`	Arbeitsbereichsrelativer Pfad zur Datei oder zum Ordner.
`defaultValue?`	`any`	Der zurückgegebene Fallback-Wert, wenn der angeforderte Pfad fehlt.

Rückgaben

Name	Typ	Beschreibung
`pathValue`	`any \| nil`	Wert am angeforderten Pfad oder der Fallback-Wert.

Beschreibung

Liest einen verschachtelten Wert aus einer Tabelle mithilfe eines gepunkteten Pfads oder eines Pfadarrays.

Rufe es mit 3 Parameter(n) auf: object, path, defaultValue. Die Argumenttabelle erklärt, welche Werte erforderlich sind und welche nur das Verhalten verfeinern.

Es gibt pathValue (any | nil) zurück. Nutze die Rückgabetabelle, um erfolgreiche Werte von nil-Ergebnissen und behandelbaren Fehlern zu trennen.

Beispiel

Liest einen verschachtelten Wert mit einem Fallback, wenn der Pfad fehlt.

local document = {
    user = {
        profile = { name = "Guest" },
    },
}

local name = json.getPath(document, { "user", "profile", "name" }, "Unknown")
print(name)