الدالة str.format_map() في بايثون
تؤدّي هذه الدالة عمليات التنسيق على السلسلة النصية بواسطة قاموس.
البنية العامة
x.format_map()
المعاملات
mapping
قاموس تستخدمه الدالة لتنسيق السلسلة النصية.
القيمة المعادة
تعيد هذه الدالة السلسلة النصية بعد إجراء عمليات التنسيق عليها بواسطة القاموس الممرّر في الوسائط.
تشبه هذه الدالة في عملها الدالة str.format(**mapping)، باستثناء أنّ الدالة str.format_map() تستخدم المعامل mapping مباشرة ولا تنسخه إلى قاموس جديد.
ملاحظة: هذه الدالة جديدة في الإصدار 3.2 من اللغة.
أمثلة
يستخدم المثال التالي قاموسًا لتنسيق السلسلة النصية:
>>> name = {'first': 'Samir', 'last': 'Jaber'}
>>> print ('Your name is: {first} {last}'.format_map(name))
Your name is: Samir Jaber
هذه الدالة مفيدة عندما يكون mapping صنفًا فرعيًّا من نوع dict:
>>> class Default(dict):
... def __missing__(self, key):
... return key
...
>>> '{name} was born in {country}'.format_map(Default(name="Ahmed"))
'Ahmed was born in country'
>>> '{name} was born in {country}'.format_map(Default(country="Egypt"))
'name was born in Egypt'
>>> '{name} was born in {country}'.format_map(Default(name="Salem", country="Egypt"))
'Salem was born in Egypt'