دمج عميق باستخدام mergeOverwrite وdict

تحتاجون أحيانًا إلى تجميع map داخل قالب. تنشئ الدالة dict واحدةً من أزواج متناوبة من المفاتيح والقيم.

غالبًا ما تكون لديكم قيم افتراضية لـ chart بالإضافة إلى تجاوزات المستخدم، وتريدون map واحدة مدمجة. وهذا بالضبط ما ينتجه merge.

تنسخ الدالة merge المفاتيح من maps المصدر إلى وجهة، لكنها تُبقي قيمة الوجهة كلما كان المفتاح موجودًا مسبقًا.

مع merge، يفوز الوسيط الأول عند وجود أي مفتاح متعارض، ولذلك تكون الدالة مناسبة عندما يجب أن تتجاوز مدخلات المستخدم القيم الافتراضية لديكم.

تفعل الدالة mergeOverwrite العكس: إذ تستبدل maps المصدر اللاحقة قيم الوجهة، فتضيف القيم على شكل طبقات.

تدمج كلتا الدالتين المساعدتين بشكل recursive: إذ تُدمج maps المتداخلة مفتاحًا بمفتاح بدلًا من استبدال الشجرة الفرعية بأكملها.

انتبهوا: تعدّل merge وmergeOverwrite الوسيط الأول لهما مباشرةً. مرّروا dict جديدة إذا كان يجب الحفاظ على الأصل دون تغيير.

من الأنماط الشائعة البدء بـ dict للقيم الافتراضية، ثم إضافة قيم المستخدم فوقها حتى تعود المفاتيح غير المعيّنة إلى قيم آمنة افتراضيًا.

بعد الدمج، تتعاملون مع النتيجة مثل أي map، وتستخرجون المفاتيح باستخدام dot أو دالة index كالمعتاد.

لإخراج بنية مدمجة بصيغة YAML، مرّروها عبر toYaml وnindent حتى توضع الكتلة عند مستوى المسافة البادئة الصحيح.

عندما يكون اسم المفتاح ديناميكيًا أو يتضمن أحرفًا غير اعتيادية، استخدموا دالة index للوصول إلى map بدلًا من الوصول باستخدام dot.

تحقّق سريع من اتجاه الكتابة فوق القيم.

تعرّفتم إلى dict لإنشاء maps، وإلى merge للحفاظ على مفاتيح الوجهة، وإلى mergeOverwrite لمنح القيم اللاحقة الأولوية، مع إجراء كل عمليات الدمج بعمق. 🎉