التابع match.expand()‎ في بايثون

يجري هذا التابع عملية استبدال التسلسلات المسبوقة بالخط المائل العكسي بالاعتماد على قالب متمثّلٍ بسلسلة نصية.

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

match.expand(template)

المعاملات

template

سلسلة نصية تمثّل القالب الذي سيستخدمه التابع لإجراء عمليات الاستبدال.

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

يعيد التابع السلسلة النصية الناتجة عن إجراء عمليات عملية استبدال التسلسلات المسبوقة بالخط المائل العكسي بالاعتماد على قالب متمثّلٍ بسلسلة نصية، وبنفس طريقة عمل التابع regex.sub()‎. إذ تُحوّل تسلسلات التهريب مثل ‎\n إلى المحارف المقابلة، وتحوّل الإشارات الخلفية الرقمية مثل (‎\2، \1) والإشارات الخلفية المسمّاة مثل (‎\g<1> ،\g<name>‎) بالمحتوى المقابل للمجموعة.

ملاحظة: في الإصدار 3.5 من اللغة يستبدل التابع المجموعات غير المتطابقة بسلاسل نصية فارغة.

أمثلة

يبين المثال التالي النتائج المعادة من هذا التابع:

>>> import re
>>> str = "Hsoub Wiki"
>>> pattern = r'(?P<name>\w+)\s+(\w+)'
>>> match = re.search(pattern, str)
>>> if match:
...     match.expand(r'\g<name>')
... 
'Hsoub'
>>> if match:
...     match.expand(r'\2')
... 
'Wiki'

انظر أيضًا

• التابع [Python/regex/sub|regex.sub()]

مصادر

• [قسم match في صفحة Regular expression operations في توثيق بايثون الرسمي].