Справочник 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"}Ku8Разобранный KuValue не может напрямую участвовать в целочисленной арифметике. Сначала преобразуйте его через .as_int()? или .as_str()?. Несоответствие типа возвращает ошибку. Отсутствующие ключи объекта тоже возвращают ошибки, а не автоматические значения по умолчанию.
Данные и границы
Раздел «Данные и границы»Поддерживаемые входные данные: строки, логические значения, целые числа, конечные числа с плавающей точкой, null, вложенные массивы, объекты со строковыми ключами и представимые структуры. Функции, Tasks, дескрипторы ресурсов, Results, перечисления и циклические ссылки не кодируются.
| Правило | Текущая реализация |
|---|---|
| Синтаксис JSON | Строгий; отклоняет комментарии, завершающие запятые, лишний ввод после значения и некорректный Unicode |
| Вход / выход | Каждый ограничен 1 000 000 байт |
| Глубина | Корневая глубина 0; отклоняет depth > 32; 33 уровня пустых контейнеров принимаются, 34 отклоняются |
| Целые числа | Знаковые 64-битные; переполнение — ошибка, без автоматического преобразования в float |
| Плавающая точка | Конечные binary64; исходная запись, метки float и отрицательный ноль не сохраняются |
| Unicode | Китайский текст, эмодзи, экранирование, встроенный NUL |
| Повторные ключи объекта | При разборе сохраняется последнее значение |
| Порядок ключей | Кодирование сортирует по порядку байтов UTF-8 |
1.0 может кодироваться как 1. Если целочисленная запись float выходит за int64, кодировщик добавляет .0: 1e20 становится 100000000000000000000.0 и декодируется обратно. Конечные binary64 не сохраняют исходное написание, метку float и знак отрицательного нуля. Исправление включено в выпуск.
Ошибки
Раздел «Ошибки»Обрабатываемые ошибки используют домен json. Частые коды: parse_error, stringify_error и out_of_memory. byte N в сообщении разбора — смещение в байтах UTF-8 от нуля. Минимальный обработчик некорректного ввода приведён в ошибках и устранении неполадок.
Поддержка бэкендов
Раздел «Поддержка бэкендов»Реализации JSON есть в интерпретаторе, упакованном средстве запуска по умолчанию и синхронном нативном C-бэкенде. Ограниченное нативное подмножество Task и LLVM не поддерживают JSON. Импорты обычного средства запуска всё ещё зависят от расположения исходных файлов; поддержка JSON не означает полностью независимый пакет.