JSON

json.encodePretty

إجراء تسلسل لقيمة Luau إلى JSON بتنسيق قابل للقراءة.

الصيغة

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

الوسائط

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

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

الاسمالنوعالوصف
jsonstringنتيجة سلسلة JSON.

الوصف

إجراء تسلسل لقيمة Luau إلى JSON بتنسيق قابل للقراءة.

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

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

مثال

قم بتشفير قيمة كقيمة JSON متعددة الأسطر قابلة للقراءة.

local text = json.encodePretty({
    name = "Real",
    version = 1,
    features = { "docs", "examples" },
})

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 حرفًا.