Αναφορά JSON
Αυτή η σελίδα δεν είναι διαθέσιμη στην επιλεγμένη γλώσσα. Εμφανίζεται η αγγλική τεκμηρίωση της ίδιας έκδοσης.
Στιγμιότυπο 0.0.19 Τεκμηρίωση
Το 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"}Ku8Ένα αναλυμένο 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
Ενότητα με τίτλο «Υποστήριξη backend»Ο διερμηνευτής, ο προεπιλεγμένος συσκευασμένος εκκινητής και ο σύγχρονος εγγενής backend C διαθέτουν υλοποιήσεις JSON. Το περιορισμένο εγγενές υποσύνολο Task και το LLVM δεν υποστηρίζουν JSON. Οι εισαγωγές του προεπιλεγμένου εκκινητή εξακολουθούν να εξαρτώνται από τις θέσεις πηγής· η υποστήριξη JSON δεν συνεπάγεται πλήρως ανεξάρτητο πακέτο.