JSON

json.getPath

يقرأ قيمة متداخلة من جدول باستخدام مسار منقط أو صفيف مسار.

الصيغة

json.getPath(object: table, path: string | table, defaultValue?: any): any | nil
أسماء بديلة json.getpath

الوسائط

الاسمالنوعالوصف
objecttableكائن أو جدول أو قيمة رسمية لفحصها أو تغييرها.
pathstring | tableالمسار النسبي لمساحة العمل إلى الملف أو المجلد.
defaultValue?anyيتم إرجاع القيمة الاحتياطية عندما يكون المسار المطلوب مفقودًا.

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

الاسمالنوعالوصف
pathValueany | nilالقيمة في المسار المطلوب، أو القيمة الاحتياطية.

الوصف

يقرأ قيمة متداخلة من جدول باستخدام مسار منقط أو صفيف مسار.

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

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

مثال

قراءة قيمة متداخلة مع احتياطي عندما يكون المسار مفقودًا.

local document = {
    user = {
        profile = { name = "Guest" },
    },
}

local name = json.getPath(document, { "user", "profile", "name" }, "Unknown")
print(name)