Μετάβαση στο περιεχόμενο
Ελληνικά

Αναφορά JSON

Αυτή η σελίδα δεν είναι διαθέσιμη στην επιλεγμένη γλώσσα. Εμφανίζεται η αγγλική τεκμηρίωση της ίδιας έκδοσης.

Στιγμιότυπο 0.0.18 Τεκμηρίωση

Το std.json κωδικοποιεί και αποκωδικοποιεί JSON. Το json.encode δανείζεται την είσοδο μόνο για ανάγνωση· το json.decode δημιουργεί ανεξάρτητα κατεχόμενο KuValue. Και τα δύο επιστρέφουν Result. Τα stringify, parse, try_parse διατηρούνται για συμβατότητα.

import json from "std.json"
Διεπαφή Επιστρέφει Σημασία
json.stringify(&value:any) str! Κωδικοποίηση μόνο για ανάγνωση σε νέο συμπαγές κείμενο JSON
json.parse(text:str) KuValue! Αυστηρή ανάλυση σε δυναμική τιμή με ανεξάρτητη κυριότητα
json.try_parse(text:str) KuValue! Ψευδώνυμο συμβατότητας για το parse
json.encode(&value:any) str! Ψευδώνυμο του stringify που περιλαμβάνεται στην έκδοση
json.decode(text:str) KuValue! Ψευδώνυμο του parse που περιλαμβάνεται στην έκδοση

Το ! δηλώνει Result. Χρησιμοποιήστε ? για προώθηση σφαλμάτων ή try/catch για χειρισμό τους. Η κωδικοποίηση δεν καταναλώνει ούτε τροποποιεί την είσοδο.

Πλήρες βασικό παράδειγμα· περισσότερες χρήσεις στο 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)
}

Τα κλειδιά αντικειμένου ταξινομούνται ντετερμινιστικά. Αναμενόμενη έξοδος:

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

Ένα αναλυμένο KuValue δεν μπορεί να συμμετέχει άμεσα σε ακέραια αριθμητική. Πρώτα μετατρέψτε με .as_int()? ή .as_str()?. Ασύμβατος τύπος επιστρέφει σφάλμα. Απόντα κλειδιά αντικειμένου επιστρέφουν επίσης σφάλματα αντί για αυτόματες προεπιλογές.

Οι υποστηριζόμενες είσοδοι περιλαμβάνουν συμβολοσειρές, λογικές τιμές, ακεραίους, πεπερασμένους αριθμούς κινητής υποδιαστολής, null, εμφωλευμένους πίνακες, αντικείμενα με κλειδιά συμβολοσειρών και αναπαραστάσιμες δομές. Συναρτήσεις, Tasks, χειριστήρια πόρων, Results, απαριθμήσεις και κύκλοι δεν κωδικοποιούνται.

Κανόνας Τρέχουσα υλοποίηση
Σύνταξη JSON Αυστηρή· απορρίπτει σχόλια, τελικά κόμματα, πρόσθετη είσοδο μετά την τιμή και μη έγκυρο Unicode
Είσοδος / έξοδος Καθεμία περιορίζεται σε 1.000.000 byte
Προϋπολογισμός βάθους Η ρίζα έχει βάθος 0· απορρίπτει depth > 32· δέχεται 33 επίπεδα κενών περιεκτών, απορρίπτει 34
Ακέραιοι Προσημασμένοι 64 bit· η υπερχείλιση είναι σφάλμα, χωρίς αυτόματη μετατροπή σε float
Κινητή υποδιαστολή Πεπερασμένο binary64· δεν διατηρούνται η αρχική γραφή, οι ετικέτες float και το αρνητικό μηδέν
Unicode Κινεζικά, emoji, ακολουθίες διαφυγής, ενσωματωμένο NUL
Διπλά κλειδιά αντικειμένου Η ανάλυση κρατά την τελευταία τιμή
Σειρά κλειδιών Η κωδικοποίηση ταξινομεί βάσει σειράς byte UTF-8

Το 1.0 μπορεί να κωδικοποιηθεί ως 1. Αν το ακέραιο κείμενο ενός float υπερβαίνει int64, προστίθεται .0: το 1e20 γίνεται 100000000000000000000.0 και αποκωδικοποιείται ξανά. Πεπερασμένα binary64 δεν διατηρούν αρχική γραφή, ετικέτα float ή πρόσημο αρνητικού μηδενός. Η διόρθωση περιλαμβάνεται.

Τα ανακτήσιμα σφάλματα χρησιμοποιούν τον τομέα json. Συνήθεις κωδικοί είναι parse_error, stringify_error και out_of_memory. Το byte N σε μήνυμα ανάλυσης είναι μετατόπιση byte UTF-8 με αρχή το μηδέν. Δείτε τα σφάλματα και την αντιμετώπιση προβλημάτων για ελάχιστο χειριστή μη έγκυρης εισόδου.

Ο διερμηνευτής, ο προεπιλεγμένος συσκευασμένος εκκινητής και ο σύγχρονος εγγενής backend C διαθέτουν υλοποιήσεις JSON. Το περιορισμένο εγγενές υποσύνολο Task και το LLVM δεν υποστηρίζουν JSON. Οι εισαγωγές του προεπιλεγμένου εκκινητή εξακολουθούν να εξαρτώνται από τις θέσεις πηγής· η υποστήριξη JSON δεν συνεπάγεται πλήρως ανεξάρτητο πακέτο.

std.json.