عرض مصدر Python/string/Template

<noinclude>{{DISPLAYTITLE:سلاسل القوالب في بايثون}}</noinclude>

تقدّم القوالب طريقة أبسط لإجراء عمليات الاستبدال في السلاسل النصية الموصوفة في PEP 292. حيث يمكن إجراء عمليات الاستبدال باستخدام الرمز $ بدلًا من الرمز %، وباتباع القواعد التالية:

* يعتبر التسلسل $$ تسلسل تهريب، ويجري استبداله بعلامة $ واحدة.
* تسمّي الصيغة ‎$identifier معرّفًا يحدّد موضعًا للاستبدال يطابق مفتاح ربط يحمل الاسم "identifier". المعرّفات الصالحة هي تلك التي تتضمّن حروفًا وأرقامًا بترميز ASCII وتكون غير حساسة لحالة الأحرف، وتبدأ بشرطة سفلية أو أحد حروف الترميز ASCII. وينتهي اسم المحرّف عند أوّل حرف لا تنطبق عليه هذه القيود.
* الصيغة ‎${identifier}‎ مكافئة للصيغة ‎$identifier، وتُستخدم في الحالات التي يتضمّن فيها المعرّف حروفًا صالحة ولكنّها ليست جزءًا من اسم المعرّف مثل: ‎"${noun}ification"‎.

يؤدي ظهور الرمز $ في أي مكان آخر ضمن السلسلة النصية إلى إطلاق الخطأ ValueError.

تقدّم وحدة string الصنف Template الذي يستخدم القواعد الآنفة الذكر في عمله، ويدعم هذا الصنف خاصية واحدة وتابعين.

== خاصية الصنف Template ==
=== <code>template</code> ===
تمثّل الكائن الممرّر كمعامل للتابع الباني للصنف Template، وعادة لا يجدر تغيير قيمة هذه الخاصية، ولكن ذلك ليس أمرًا إلزاميًا.

== تابعا الصنف Template ==

يقدّم الصنف <code>Template</code> التابعين التاليين:

=== التابع <code>Template.substitue()‎</code> ===

يؤدي هذا التابع عملية الاستبدال بالاعتماد على القالب ويعيد سلسلة نصية جديدة.

=== التابع <code>Template.safe_substitue()‎</code> ===

هذا التابع مشابه للتابع السابق، باستثناء أنّه لا يطلق خطأً أو استثناءً عند حدوث مشكلة أثناء عملية الاستبدال.

== مصادر ==

[https://docs.python.org/3/library/string.html#template-strings قسم Template Strings في صفحة Common String Operations في توثيق بايثون الرسمي].

[[تصنيف: Python]]
[[تصنيف: Python Modules]]