JSON-Referenz

Die Ergänzungen zu v0.0.18 folgen derzeit auf Englisch; die übrige Übersetzung bleibt erhalten. English · 简体中文

json.encode / json.decode are available in v0.0.18 and share the stringify / parse implementations. Compatibility names remain available. The previous JSON implementation remains the default; yyjson is not used.

Import und Schnittstellen

import json from "std.json"

Schnittstelle	Rückgabe	Bedeutung
json.stringify(&value:any)	str!	Schreibgeschützte Kodierung in neuen kompakten JSON-Text
json.parse(text:str)	KuValue!	Strenges Parsen in einen dynamischen Wert mit unabhängigem Besitz
json.try_parse(text:str)	KuValue!	Kompatibilitätsalias für parse
json.encode(&value:any)	str!	Alias für stringify im Entwicklungszweig
json.decode(text:str)	KuValue!	Alias für parse im Entwicklungszweig

! bezeichnet Result. Verwenden Sie ? zum Weiterreichen von Fehlern oder try/catch zu ihrer Behandlung. Die Kodierung verbraucht oder verändert die Eingabe nicht.

Werte kodieren und lesen

Dies ist ein vollständiges Grundbeispiel. Im Entwicklungszweig steht ein umfangreicheres Regressionsbeispiel unter examples/json.ku.

import json from "std.json"

fn main(): null! {
    value = { name: "Ku", count: 7 }
    text = json.stringify(value)?
    println(text)

    decoded = json.parse(text)?
    println(decoded["name"]?.as_str()?)
    println(decoded["count"]?.as_int()? + 1)
    return ok(null)
}

Objektschlüssel werden deterministisch sortiert. Erwartete Ausgabe:

{"count":7,"name":"Ku"}
Ku
8

Ein geparster KuValue kann nicht direkt an Ganzzahlarithmetik teilnehmen. Konvertieren Sie zuerst mit .as_int()? oder .as_str()?. Ein unpassender Typ gibt einen Fehler zurück. Auch fehlende Objektschlüssel liefern Fehler statt automatischer Standardwerte.

Daten und Grenzen

Unterstützte Eingaben sind Strings, boolesche Werte, Ganzzahlen, endliche Gleitkommazahlen, null, verschachtelte Arrays, Objekte mit Stringschlüsseln und darstellbare Structs. Funktionen, Tasks, Ressourcen-Handles, Results, Enums und Zyklen können nicht kodiert werden.

Regel	Aktuelle Implementierung
JSON-Syntax	Streng; lehnt Kommentare, nachgestellte Kommas, zusätzlichen nachgestellten Inhalt und ungültiges Unicode ab
Eingabe / Ausgabe	Jeweils auf 1.000.000 Bytes begrenzt
Tiefenbudget	Wurzeltiefe ist 0; lehnt depth > 32 ab; 33 Ebenen leerer Container werden akzeptiert, 34 abgelehnt
Ganzzahlen	Vorzeichenbehaftete 64-Bit-Werte; Überlauf ist ein Fehler, ohne automatische Float-Konvertierung
Gleitkomma	Endliches binary64; ursprüngliche Schreibweise, Float-Kennzeichnung und negatives Null werden nicht erhalten
Unicode	Chinesisch, Emojis, Escape-Sequenzen, eingebettetes NUL
Doppelte Objektschlüssel	Beim Parsen bleibt der letzte Wert erhalten
Schlüsselreihenfolge	Die Kodierung sortiert nach UTF-8-Bytereihenfolge

A float such as 1.0 may encode as 1. When an integer-looking float is outside int64, the encoder adds .0 to keep decoding on the float path: 1e20 encodes as 100000000000000000000.0 and decodes again. Finite binary64 values do not preserve original spelling, a float tag or the sign of negative zero.

Fehler

Behebbare Fehler verwenden die Domäne json. Häufige Codes sind parse_error, stringify_error und out_of_memory. byte N in einer Parsemeldung ist ein nullbasierter UTF-8-Byteoffset. Ein minimaler Handler für ungültige Eingaben steht unter Fehler und Fehlerbehebung.

Backend-Unterstützung

Interpreter, standardmäßig verpackter Runner und synchrones natives C-Backend besitzen JSON-Implementierungen. Die eingeschränkte native Task-Teilmenge und LLVM unterstützen JSON nicht. Imports des Standard-Runners hängen weiterhin von ihren Quellorten ab; JSON-Unterstützung bedeutet kein vollständig unabhängiges Paket.

Die Signaturen und Grenzen dieser Seite wurden anhand von Quelltext und Verträgen geprüft. Ausführungsprüfungen müssen Version, Commit und Backend nennen. Siehe den vollständigen JSON-Syntaxvertrag.