Real Dokumentation

Syntax

json.encode(value: any, options?: EncodeOptions): string

Argumente

Name	Typ	Beschreibung
`value`	`any`	Neuer Wert zum Schreiben.
`options?`	`EncodeOptions`	Optionale Einstellungstabelle, die das Verhalten des Vorgangs steuert.

Rückgaben

Name	Typ	Beschreibung
`json`	`string`	JSON-String-Ergebnis.

Beschreibung

Serialisiert einen Luau-Wert mithilfe optionaler Formatierungs- und Codierungsregeln in JSON.

Rufe es mit 2 Parameter(n) auf: value, options. Die Argumenttabelle erklärt, welche Werte erforderlich sind und welche nur das Verhalten verfeinern.

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

Beispiel

Codieren Sie eine Tabelle als JSON-Format mit stabiler Schlüsselreihenfolge.

local payload = {
    name = "Real",
    enabled = true,
    tags = { "api", "docs" },
}

local text = json.encode(payload, {
    pretty = true,
    sortKeys = true,
})

print(text)

Typen

EncodeOptions

Steuert die JSON-Serialisierung und -Formatierung.

pretty? boolean Ermöglicht eine formatierte, mehrzeilige JSON-Ausgabe.sortKeys? boolean Sortiert Objektschlüssel vor der Codierung.emptyTableAsArray? boolean Kodiert eine leere Tabelle als Array statt als Objekt.errorOnUnsupported? boolean Löst einen Fehler aus, anstatt nicht unterstützte Werte zu ersetzen.encodeInvalidNumbersAsNull? boolean Kodiert NaN und unendliche Zahlen als JSON-Null.maxDepth? integer Legt die maximale Verschachtelungstiefe fest, geklemmt von 1 bis 4096.indent? string Legt die Einrückungszeichenfolge fest, begrenzt auf 32 Zeichen.