عرض مصدر Python/str/format

<noinclude>{{DISPLAYTITLE:التابع <code>str.format()‎</code> في بايثون}}</noinclude>
يجري هذا التابع عمليات التنسيق على السلسلة النصية بواسطة [[Python/arguments|معاملات موضعية]] أو [[Python/arguments#.D9.85.D8.B9.D8.A7.D9.85.D9.84.D8.A7.D8.AA .D8.A7.D9.84.D9.83.D9.84.D9.85.D8.A7.D8.AA .D8.A7.D9.84.D9.85.D9.81.D8.AA.D8.A7.D8.AD.D9.8A.D8.A9|مفتاحية]].

== البنية العامة ==
<syntaxhighlight lang="python3">
x.format()
</syntaxhighlight>

== القيمة المعادة ==
يجري هذا التابع عمليات التنسيق على [[Python/str|السلسلة النصية]]، ويمكن للسلسلة النصية أن تحتوي على حروف اعتيادية أو حقول الاستبدال المحاطة بالأقواس المعقوفة <code>{}</code>. يمكن لكل حقل استبدال أن يحتوي على الفهرس الرقمي التابع [[Python/arguments|للوسيط الموضعي]]، أو اسم [[Python/arguments#.D9.85.D8.B9.D8.A7.D9.85.D9.84.D8.A7.D8.AA .D8.A7.D9.84.D9.83.D9.84.D9.85.D8.A7.D8.AA .D8.A7.D9.84.D9.85.D9.81.D8.AA.D8.A7.D8.AD.D9.8A.D8.A9|الوسيط المفتاحي]].

يعيد التابع نسخة من [[Python/str|السلسلة النصية]] حيث تبدّل حقول الاستبدال بقيمة [[Python/str|السلسلة النصية]] الخاصّة بالوسيط المقابل.

== أمثلة ==
تعرض الأمثلة التالية طرق استخدام التابع format() لتنفيذ العديد من العمليات البسيطة والمعقدة:

* الوصول إلى المعاملات بواسطة الموقع:
<syntaxhighlight lang="python3">
>>> '{0}, {1}, {2}'.format('a', 'b', 'c')
'a, b, c'
>>> '{}, {}, {}'.format('a', 'b', 'c')  # 3.1+ فقط
'a, b, c'
>>> '{2}, {1}, {0}'.format('a', 'b', 'c')
'c, b, a'
>>> '{2}, {1}, {0}'.format(*'abc')      # فك تحزيم تسلسل المعاملات
'c, b, a'
>>> '{0}{1}{0}'.format('abra', 'cad')   # يمكن تكرار مواقع المعاملات
'abracadabra'
</syntaxhighlight>

* الوصول إلى المعاملات بواسطة الاسم:
<syntaxhighlight lang="python3">
>>> 'Coordinates: {latitude}, {longitude}'.format(latitude='37.24N', longitude='-115.81W')
'Coordinates: 37.24N, -115.81W'
>>> coord = {'latitude': '37.24N', 'longitude': '-115.81W'}
>>> 'Coordinates: {latitude}, {longitude}'.format(**coord)
'Coordinates: 37.24N, -115.81W'
</syntaxhighlight>

* الوصول إلى خصائص المعاملات:
<syntaxhighlight lang="python3">
>>> c = 3-5j
>>> ('The complex number {0} is formed from the real part {0.real} '
...  'and the imaginary part {0.imag}.').format(c)
'The complex number (3-5j) is formed from the real part 3.0 and the imaginary part -5.0.'
>>> class Point:
...     def __init__(self, x, y):
...         self.x, self.y = x, y
...     def __str__(self):
...         return 'Point({self.x}, {self.y})'.format(self=self)
...
>>> str(Point(4, 2))
'Point(4, 2)'
</syntaxhighlight>

* الوصول إلى العناصر التابعة للمعاملات:
<syntaxhighlight lang="python3">
>>> coord = (3, 5)
>>> 'X: {0[0]};  Y: {0[1]}'.format(coord)
'X: 3;  Y: 5'
</syntaxhighlight>

* إزاحة النصوص وتعيين عرض السلسلة النصية:
<syntaxhighlight lang="python3">
>>> '{:<30}'.format('left aligned')
'left aligned                  '
>>> '{:>30}'.format('right aligned')
'                 right aligned'
>>> '{:^30}'.format('centered')
'           centered           '
>>> '{:*^30}'.format('centered')  # use '*' as a fill char
'***********centered***********'
</syntaxhighlight>

* استخدام الرمز (<code>,</code>) كفاصلة عشرية:
<syntaxhighlight lang="python3">
>>> '{:,}'.format(1234567890)
'1,234,567,890'
</syntaxhighlight>

* عرض النتيجة كنسبة مئوية:
<syntaxhighlight lang="python3">
>>> points = 19
>>> total = 22
>>> 'Correct answers: {:.2%}'.format(points/total)
'Correct answers: 86.36%'
</syntaxhighlight>

* استخدام طريقة تنسيق خاصة بنوع معين من أنواع البيانات:
<syntaxhighlight lang="python3">
>>> import datetime
>>> d = datetime.datetime(2010, 7, 4, 12, 15, 58)
>>> '{:%Y-%m-%d %H:%M:%S}'.format(d)
'2010-07-04 12:15:58'
</syntaxhighlight>

* استخدام المعاملات المتداخلة وبعض الأمثلة المعقدة:
<syntaxhighlight lang="python3">
>>> for align, text in zip('<^>', ['left', 'center', 'right']):
...     '{0:{fill}{align}16}'.format(text, fill=align, align=align)
...
'left<<<<<<<<<<<<'
'^^^^^center^^^^^'
'>>>>>>>>>>>right'
>>>
>>> octets = [192, 168, 0, 1]
>>> '{:02X}{:02X}{:02X}{:02X}'.format(*octets)
'C0A80001'
>>> int(_, 16)
3232235521
>>>
>>> width = 5
>>> for num in range(5,12): 
...     for base in 'dXob':
...         print('{0:{width}{base}}'.format(num, base=base, width=width), end=' ')
...     print()
...
    5     5     5   101
    6     6     6   110
    7     7     7   111
    8     8    10  1000
    9     9    11  1001
   10     A    12  1010
   11     B    13  1011
</syntaxhighlight>

== انظر أيضًا ==
* [[Python/str|السلاسل النصية في بايثون.]]
* التابع <code>[[Python/str/capitalize|str.capitalize()‎]]</code>: إعادة نسخة من السلسلة النصية مع تحويل الحرف الأول إلى حرف كبير، والأحرف الباقية إلى أحرف صغيرة.
* التابع <code>[[Python/str/casefold|str.casefold()‎]]</code>: إعادة السلسلة النصية بحالة casefolded، ويمكن استخدام هذا النوع من السلاسل لإجراء المقارنة دون الاعتماد على حالة الأحرف.
* التابع <code>[[Python/str/center|str.center()‎]]</code>: إعادة أحرف السلسلة النصية مزاحة نحو الوسط ضمن سلسلة نصّية ذات طول محدّد.
* التابع <code>[[Python/str/count|str.count()‎]]</code>: إعادة عدد مرات ظهور سلسلة نصية فرعية ضمن السلسلة الأصلية.
* التابع <code>[[Python/str/encode|str.encode()‎]]</code>: إعادة نسخة مرمّزة من السلسلة النصية على هيئة <nowiki/>[[Python/bytes|بايتات]].
* التابع <code>[[Python/str/endswith|str.endswith()‎]]</code>: التحقق من وجود سلسلة نصية فرعية في نهاية السلسلة النصية الأصلية.
* التابع <code>[[Python/str/expandtabs|str.expandtabs()‎]]</code>: إعادة نسخة من السلسلة النصية بعد تحويل جميع علامات الجدولة إلى مسافة بيضاء واحدة أو أكثر.
* التابع <code>[[Python/str/find|str.find()‎]]</code>: إعادة أدنى قيمة للفهرس في السلسلة النصية والذي تكون السلسلة الفرعية موجودة فيه ضمن الجزء المقتطع من السلسلة.
* التابع <code>[[Python/str/format_map|str.format_map()‎]]</code>: إجراء عمليات التنسيق على السلسلة النصية بواسطة <nowiki/>[[Python/dict|قاموس]].
* التابع <code>[[Python/str/index|str.index()‎]]</code>: إجراء نفس وظيفة الدالة <code>[[Python/str/find|str.find()‎]]</code>.
* التابع <code>[[Python/str/isalnum|str.isalnum()‎]]</code>: التحقق ممّا إذا كانت السلسلة النصية تضمّ حروفًا وأرقامًا وأنّها تضمّ حرفًا واحدًا على الأقل.
* التابع <code>[[Python/str/isalpha|str.isalpha()‎]]</code>: التحقق ممّا إذا كانت السلسلة النصية مكوّنة من الحروف فقط، وأنّ فيها حرفًا واحدًا على الأقل.
* التابع <code>[[Python/str/isdecimal|str.isdecimal()‎]]</code>: التحقق ممّا إذا كانت السلسلة النصية مكوّنة من حروف الأعداد العشرية فقط، وأنّ فيها حرفًا واحدًا على الأقل.
* التابع <code>[[Python/str/isdigit|str.isdigit()‎]]</code>: التحقق ممّا إذا كانت السلسلة النصية مكوّنة من حروف الأعداد (digits) فقط، وأنّ فيها حرفًا واحدًا على الأقل.
* التابع <code>[[Python/str/isidentifier|str.isidentifier()‎]]</code>: التحقق ممّا إذا كانت السلسلة النصية تتضمّن معرّفًا صحيحًا (identifier) في لغة بايثون.
* التابع <code>[[Python/str/islower|str.islower()‎]]</code>: التحقق ممّا إذا كانت حروف السلسلة النصية حروفًا صغيرة (lowercase).
* التابع <code>[[Python/str/isnumeric|str.isnumeric()‎]]</code>: التحقق ممّا إذا كانت جميع الحروف في السلسلة النصية حروفًا عددية، وأنّ هناك حرفًا واحدًا على الأقل في تلك السلسلة.
* التابع <code>[[Python/str/isprintable|str.isprintable()‎]]</code>: التحقق ممّا إذا كانت جميع الحروف في السلسلة النصية قابلة للطباعة أو أن السلسلة النصية فارغة.
* التابع <code>[[Python/str/isspace|str.isspace()‎]]</code>: التحقق ممّا إذا كانت السلسلة النصية مكوّنة من حروف مسافات بيضاء فقط وأنّ في السلسلة حرفًا واحدًا على الأقل.
* التابع <code>[[Python/str/istitle|str.istitle()‎]]</code>: التحقق ممّا إذا كانت أوائل الكلمات في السلسلة النصية حروفًا كبيرة (titlecased).
* التابع <code>[[Python/str/isupper|str.isupper()‎]]</code>: التحقق ممّا إذا كانت جميع الحروف في السلسلة النصية حروفًا كبيرة.
* التابع <code>[[Python/str/join|str.join()‎]]</code>: إعادة السلسلة النصية الناتجة عن ربط السلاسل النصية التابعة لكائن قابل للتكرار (iterable).
* التابع <code>[[Python/str/ljust|str.ljust()‎]]</code>: إعادة أحرف السلسلة النصية مزاحة نحو اليسار ضمن سلسلة نصّية ذات طول محدّد.
* التابع <code>[[Python/str/lower|str.lower()‎]]</code>: تحويل جميع الحروف في السلسلة النصية إلى حروف صغيرة.
* التابع <code>[[Python/str/lstrip|str.lstrip()‎]]</code>: حذف الحروف التي يحدّدها المستخدم من بداية السلسلة النصية.
* التابع <code>[[Python/str/maketrans|str.maketrans()‎]]</code>: إعادة جدول تحويل يمكن استخدامه بواسطة الدالة <code>[[Python/str/translate|str.translate()]]‎</code>.
* التابع <code>[[Python/str/partition|str.partition()‎]]</code>: تقسيم السلسلة النصية عند أول ظهور للقيمة التي يحدّدها المستخدم.
* التابع <code>[[Python/str/replace|str.replace()‎]]</code>: تبديل هذه الدالة العبارة التي يختارها المستخدم - مهما تكرّرت في السلسلة النصية - إلى القيمة الجديدة التي يحدّدها.
* التابع <code>[[Python/str/rfind|str.rfind()‎]]</code>: إعادة أعلى قيمة للفهرس في السلسلة النصية حيث تجد فيه السلسلة النصية الفرعية.
* التابع <code>[[Python/str/rindex|str.rindex()‎]]</code>: إعادة أعلى قيمة للفهرس في السلسلة النصية حيث تجد فيه السلسلة النصية الفرعية.
* التابع <code>[[Python/str/rjust|str.rjust()‎]]</code>: إعادى أحرف السلسلة النصية مزاحة نحو اليمين ضمن سلسلة نصّية ذات طول محدّد.
* التابع <code>[[Python/str/rpartition|str.rpartition()‎]]</code>: تقسيم السلسلة النصية عند آخر ظهور للقيمة التي يحدّدها المستخدم.
* التابع <code>[[Python/str/rsplit|str.rsplit()‎]]</code>: تحويل السلسلة النصية من جهة اليمين إلى <nowiki/>[[Python/list|قائمة]] من السلاسل النصية بالاعتماد على الفاصل الذي يحدّده المستخدم.
* التابع <code>[[Python/str/rstrip|str.rstrip()‎]]</code>: حذف الحروف التي يحدّدها المستخدم من نهاية السلسلة النصية.
* التابع <code>[[Python/str/split|str.split()‎]]</code>: تقسيم السلسلة النصية إلى <nowiki/>[[Python/list|قائمة]] من السلاسل النصية بالاعتماد على فاصل محدّد.
* التابع <code>[[Python/str/splitlines|str.splitlines()‎]]</code>: تقسيم السلسلة النصية إلى <nowiki/>[[Python/list|قائمة]] من الأسطر.
* التابع <code>[[Python/str/startswith|str.startswith()‎]]</code>: التحقق من أنّ السلسلة النصية تبدأ بالقيمة التي يحدّدها المستخدم.
* التابع <code>[[Python/str/strip|str.strip()‎]]</code>: حذف الحروف المحدّدة من قبل المستخدم من نهاية وبداية السلسلة النصية.
* التابع <code>[[Python/str/swapcase|str.swapcase()‎]]</code>: قلب حالة الحروف في السلسلة النصية.
* التابع <code>[[Python/str/title|str.title()‎]]</code>: تحويل أوائل الكلمات في السلسلة النصية إلى أحرف كبيرة (Title Case).
* التابع <code>[[Python/str/translate|str.translate()‎]]</code>: إعادة الحروف في السلسلة النصية بالاعتماد على جدول التحويل (translation table).
* التابع <code>[[Python/str/upper|str.upper()‎]]</code>: تحويل الحروف في السلسلة النصية إلى حروف كبيرة.
* التابع <code>[[Python/str/zfill|str.zfill()‎]]</code>: إضافة أصفار من الترميز ASCII إلى يسار السلسلة النصية لتصبح السلسلة بالطول المحدد من قبل المستخدم.

== مصادر ==
* [https://docs.python.org/3/library/stdtypes.html#str.format قسم format في صفحة Types في توثيق بايثون الرسمي.]
* [https://docs.python.org/3/library/string.html#format-examples قسم Format Examples في صفحة Common string operations في توثيق بايثون الرسمي.]
[[تصنيف:Python]]
[[تصنيف:Python Method]]
[[تصنيف:Python Types]]
[[تصنيف:Python Str]]