الدالة format()‎ في بايثون

تُحوّل الدّالة format()‎ قيمةً مُعطاةً إلى تمثيل مُنسّق حسب ما تُحدّده مواصفة التّنسيق المُعطاة.

البنية العامة

format(value[, format_spec])

المعاملات

value

القيمة المرغوب تنسيقها.

format_spec

مُعامل اختياريّ تكون قيمته الافتراضيّة سلسلةً نصيّةً عادة ما تُعطي نفس تأثير الاستدعاء str‎(‎value‎)‎.

القيمة المعادة

القيمة المُنسّقة حسب المواصفة المُعطاة.

تختلف آليّة تفسير المواصفة المُعطاة للمُعامل format_spec حسب نوع قيمة المُعامل value، لكنّ هناك بنية قياسيّة للتنسيق تُستخدم من طرف مُعظم الأنواع المُضمّنة في لغة بايثون.

أمثلة

المثال التّالي يوضّح كيفيّة عمل هذه الدّالة:

>>> format(1000000, ',') # تنسيق عدد بوضع فاصلة للآلاف
'1,000,000'

>>> format(1/10, '.2f') # تنسيق عدد عشريّ بتحديد عدد الأرقام وراء الفاصلة باثنين
'0.10'

>>> format(1/10, '.100f') # تحديد الأرقام وراء الفاصلة بمئة رقم
'0.1000000000000000055511151231257827021181583404541015625000000000000000000000000000000000000000000000'

>>> format(12, 'b') # تنسيق عدد بالمُنسّق الثّنائيّ
'1100'

ملاحظات

• يُترجَم الاستدعاء ‎format‎(‎value‎,‎ format_spec‎)‎ إلى ‎type‎(‎value‎)‎.‎__‎format‎_‎_‎(value‎,‎ format_spec‎)‎ وبما أنّ البحث يتمّ على مُستوى نوع القيمة، فسيُتَجاهل قاموس النّسخة (instance) عند البحث عن التّابع ‎_‎_‎format‎_‎_‎(‎)‎ الخاصّ بالقيمة. يُطلق استثناء TypeError إن وصل البحث عن التّابع إلى الكائن object وقيمةُ المُعامل format_spec غير فارغة. أو في حالة لم يكن المُعامل format_spec أو القيمةُ المُعادةُ سلاسل نصيّة.

انظر أيضًا

• السلاسل النصية في بايثون.
• الأعداد الصحيحة في بايثون.

مصادر

• قسم الدالة format في صفحة Functions في توثيق Python الرسمي.