str.format_map() التنسيق باستخدام كائن تعيين
آخر تحديث: 2026-09-22
str.format_map() التنسيق باستخدام كائن تعيين
str.format_map(mapping) ينسّق السلسلة النصية باستخدام كائن mapping (بدلاً من **kwargs).
| التصنيف | دوال النصوص |
|---|---|
| النوع | دوال الأنواع المدمجة |
| إصدار بايثون | all |
📝 الصياغة
str.format_map(mapping)⚙️ المعاملات
| mapping مطلوب | A mapping object supplying field values, like **kwargs. |
|---|
القيمة المُعادة：str. A new string with placeholders filled from the mapping.
يعدّل الكائن الأصلي：لا (يُعيد كائنًا جديدًا)
💥 الاستثناءات
KeyError— Raised when a placeholder field name is missing from the mapping.ValueError— Raised for an invalid format specifier.
▶ مثال
عدّل الكود واضغط تشغيل لرؤية النتيجة في لوحة المخرجات:
المخرجات：
Alice is 30💡 حالات ذات صلة
المزيد من الحالات قادم قريباً — تابعونا.
❓ أسئلة شائعة
Qما الفرق بين format_map() و format(**dict)؟
Aيستقبل format_map() كائن التخطيط مباشرةً دون توسيعه إلى وسائط من النوع keyword. وعند دمجه مع صنف فرعي من dict (مثل ما يطبّق __missing__ مثل defaultdict)، يمكنه توفير قيم افتراضية عند غياب مفتاح.
Qماذا يحدث عندما لا يوجد مفتاح؟
Aيُلقى KeyError. يمكنك إرجاع قيمة افتراضية عبر تطبيق __missing__ في صنف فرعي مخصص من dict.
Qماذا يحدث عند تمرير كائن ليس بتخطيط (mapping)؟
Aيُلقى استثناء (TypeError أو AttributeError عندما لا يدعم الكائن البحث). يجب أن يوفّر الوسيط إمكانية البحث عن قيمة الحقل.
