Riferimento JSON
Questa pagina non è disponibile nella lingua selezionata. Viene mostrata la documentazione inglese della stessa versione.
std.json codifica e decodifica JSON. json.encode prende l’ingresso in prestito in sola lettura; json.decode produce un KuValue con proprietà indipendente. Entrambi restituiscono Result. stringify, parse e try_parse rimangono compatibili.
Importazione e interfacce
Sezione intitolata «Importazione e interfacce»import json from "std.json"| Interfaccia | Restituisce | Significato |
|---|---|---|
json.stringify(&value:any) |
str! |
Codifica in sola lettura in nuovo testo JSON compatto |
json.parse(text:str) |
KuValue! |
Parsing rigoroso in un valore dinamico con proprietà indipendente |
json.try_parse(text:str) |
KuValue! |
Alias di compatibilità di parse |
json.encode(&value:any) |
str! |
Alias di stringify incluso in questa versione |
json.decode(text:str) |
KuValue! |
Alias di parse incluso in questa versione |
! indica Result. Usa ? per propagare errori oppure try/catch per gestirli. La codifica non consuma né modifica l’input.
Codifica e leggi valori
Sezione intitolata «Codifica e leggi valori»Esempio base completo; altri usi in examples/json.ku.
import json from "std.json"
fn main(): null! { value = { name: "Ku", count: 7 } text = json.encode(value)? println(text)
decoded = json.decode(text)? println(decoded["name"]?.as_str()?) println(decoded["count"]?.as_int()? + 1) return ok(null)}Le chiavi degli oggetti vengono ordinate in modo deterministico. Output atteso:
{"count":7,"name":"Ku"}Ku8Un KuValue analizzato non può partecipare direttamente all’aritmetica degli interi. Converti prima con .as_int()? o .as_str()?. Un tipo non corrispondente restituisce un errore. Anche le chiavi di oggetto assenti restituiscono errori, invece di valori predefiniti automatici.
Dati e limiti
Sezione intitolata «Dati e limiti»Gli input supportati includono stringhe, booleani, interi, numeri finiti in virgola mobile, null, array annidati, oggetti con chiavi stringa e struct rappresentabili. Non è possibile codificare funzioni, Task, handle di risorse, Results, enum e cicli.
| Regola | Implementazione attuale |
|---|---|
| Sintassi JSON | Rigorosa; rifiuta commenti, virgole finali, input aggiuntivo finale e Unicode non valido |
| Input / output | Ciascuno limitato a 1.000.000 di byte |
| Budget di profondità | La radice ha profondità 0; rifiuta depth > 32; accetta 33 livelli di contenitori vuoti e ne rifiuta 34 |
| Interi | Con segno a 64 bit; l’overflow è un errore, senza conversione automatica a virgola mobile |
| Virgola mobile | binary64 finito; rappresentazione originale, etichette float e zero negativo non vengono preservati |
| Unicode | Cinese, emoji, escape, NUL incorporato |
| Chiavi di oggetto duplicate | Il parsing conserva l’ultimo valore |
| Ordine delle chiavi | La codifica ordina secondo i byte UTF-8 |
1.0 può diventare 1. Se il testo intero di un float supera int64, il codificatore aggiunge .0: 1e20 diventa 100000000000000000000.0 e può essere decodificato di nuovo. I binary64 finiti non conservano scrittura originale, etichetta float o segno dello zero negativo. La correzione è inclusa.
Gli errori recuperabili usano il dominio json. I codici comuni sono parse_error, stringify_error e out_of_memory. Il byte N in un messaggio di parsing è un offset in byte UTF-8 con base zero. Vedi errori e risoluzione dei problemi per un gestore minimo di input non valido.
Supporto dei backend
Sezione intitolata «Supporto dei backend»L’interprete, il runner impacchettato predefinito e il backend C nativo sincrono hanno implementazioni JSON. Il sottoinsieme Task nativo ristretto e LLVM non supportano JSON. Le importazioni del runner predefinito dipendono ancora dalle posizioni dei sorgenti; il supporto JSON non implica un pacchetto totalmente indipendente.