مرجع 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"}Ku8KuValue تجزیهشده نمیتواند مستقیم در محاسبات صحیح شرکت کند. ابتدا با .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 به معنای بستهٔ کاملاً مستقل نیست.