Python/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'

انظر أيضًا

• السلاسل النصية في بايثون.
• القواميس في بايثون.
• الدالة str.format()‎ في بايثون.

مصادر

• قسم format_map في صفحة Types في توثيق بايثون الرسمي.