Перейти к содержимому
Русский

Справочник JSON

Эта страница недоступна на выбранном языке. Показана английская документация той же версии.

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 байт
Глубина Корневая глубина 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 не означает полностью независимый пакет.

std.json.