وثائق Real

الصيغة

json.encode(value: any, options?: EncodeOptions): string

الوسائط

الاسم	النوع	الوصف
`value`	`any`	قيمة جديدة للكتابة.
`options?`	`EncodeOptions`	جدول الإعدادات الاختياري الذي يتحكم في كيفية تصرف العملية.

القيم الراجعة

الاسم	النوع	الوصف
`json`	`string`	نتيجة سلسلة JSON.

الوصف

إجراء تسلسل لقيمة Luau في JSON باستخدام قواعد التنسيق والتشفير الاختيارية.

استدعه مع 2 parameter: value, options. يوضح جدول arguments القيم المطلوبة والقيم التي تضبط السلوك.

يعيد json (string). استخدم جدول returns للفصل بين قيم النجاح ونتائج nil والأخطاء القابلة للمعالجة.

مثال

قم بتشفير جدول بتنسيق JSON مع ترتيب مفاتيح ثابت.

local payload = {
    name = "Real",
    enabled = true,
    tags = { "api", "docs" },
}

local text = json.encode(payload, {
    pretty = true,
    sortKeys = true,
})

print(text)

الأنواع

EncodeOptions

يتحكم في تسلسل JSON وتنسيقه.

pretty? boolean لتمكين إخراج JSON المنسق والمتعدد الأسطر.sortKeys? boolean فرز مفاتيح الكائنات قبل الترميز.emptyTableAsArray? boolean ترميز جدول فارغ كمصفوفة بدلاً من كائن.errorOnUnsupported? boolean يثير خطأ بدلاً من استبدال قيم غير مدعومة.encodeInvalidNumbersAsNull? boolean يشفر NaN والأرقام اللانهائية كـ JSON null.maxDepth? integer يضبط الحد الأقصى لعمق التعشيش، المثبت من 1 إلى 4096.indent? string يضبط سلسلة المسافة البادئة، والتي تقتصر على 32 حرفًا.