رفتن به محتوا
فارسی

مرجع 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، آرایهٔ تودرتو، شیء با کلید رشته‌ای و ساختار قابل نمایش هستند. تابع، Task، دستگیرهٔ منبع، Result، enum و ارجاع چرخه‌ای قابل کدگذاری نیستند.

قاعده پیاده‌سازی فعلی
نحو JSON سخت‌گیرانه؛ نظرها، ویرگول پایانی، ورودی اضافی انتهایی و یونیکد نامعتبر را رد می‌کند
ورودی / خروجی هرکدام تا 1,000,000 بایت
بودجهٔ عمق عمق ریشه 0 است؛ depth > 32 رد می‌شود؛ 33 لایهٔ ظرف خالی پذیرفته و 34 رد می‌شود
اعداد صحیح ۶۴ بیتی علامت‌دار؛ سرریز خطاست و تبدیل خودکار به float انجام نمی‌شود
ممیز شناور binary64 متناهی؛ نگارش اصلی، برچسب float و صفر منفی حفظ نمی‌شود
یونیکد چینی، ایموجی، گریزها و 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 از صفر است. برای رسیدگی حداقلی به ورودی نامعتبر، خطاها و عیب‌یابی را ببینید.

مفسر، اجراکنندهٔ بسته‌بندی‌شدهٔ پیش‌فرض و مسیر C بومی همگام، پیاده‌سازی JSON دارند. زیرمجموعهٔ محدود Task بومی و LLVM از JSON پشتیبانی نمی‌کنند. واردسازی در اجراکنندهٔ پیش‌فرض همچنان به محل کد منبع وابسته است؛ پشتیبانی JSON به معنای بستهٔ کاملاً مستقل نیست.

std.json.