json.format - Real Function Reference

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

الوسائط

string

مطلوب

JSON string يتم parse له قبل formatting. Function تقرأ هذا argument باستخدام string type checking.

EncodeOptions

Optional encode options يتم تمريرها الى re-encode step. json.format يقرأ نفس encode options مثل json.encode، ثم يفرض pretty على true.

DecodeOptions

Optional decode options تستخدم اثناء parsing للـ input JSON. boolean يضبط useNull. table يمكنها ضبط useNull و maxDepth.

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

string

Readable formatted JSON string يتم انتاجه بعد parsing و re-encoding للـ input.

الأنواع

EncodeOptions

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

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

DecodeOptions

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

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

مثال

Parse existing JSON ثم re-encode له كـ readable formatted JSON.

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

print(formatted)

​الوسائط

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

​الأنواع

​EncodeOptions

​DecodeOptions

​مثال

الوسائط

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

الأنواع

EncodeOptions

DecodeOptions

مثال