وثائق Real

الصيغة

json.format(json: string, encodeOptions?: EncodeOptions, decodeOptions?: DecodeOptions): string

الوسائط

الاسم	النوع	الوصف
`json`	`string`	سلسلة JSON للتحليل أو التنسيق أو التصغير أو التحقق من الصحة.
`encodeOptions?`	`EncodeOptions`	إعدادات الترميز الاختيارية مثل الإخراج الجميل أو ترتيب المفاتيح.
`decodeOptions?`	`DecodeOptions`	إعدادات التحليل الاختيارية المستخدمة أثناء قراءة JSON.

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

الاسم	النوع	الوصف
`formatted`	`string`	سلسلة JSON منسقة.

الوصف

يوزع ويعيد تشفير JSON لتطبيع التنسيق.

استدعه مع 3 parameter: json, encodeOptions, decodeOptions. يوضح جدول arguments القيم المطلوبة والقيم التي تضبط السلوك.

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

مثال

تطبيع JSON الموجود إلى تمثيل قابل للقراءة.

local compact = '{"b":2,"a":1}'
local formatted = json.format(compact, {
    pretty = true,
    sortKeys = true,
})

print(formatted)

الأنواع

EncodeOptions

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

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

DecodeOptions

يتحكم في سلوك تحليل JSON.

useNull? boolean يمثل JSON null مع الحارس الفارغ للمكتبة بدلاً من صفر.maxDepth? integer يضبط الحد الأقصى لعمق التعشيش، المثبت من 1 إلى 4096.