التابع 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'

انظر أيضًا

• التابع regex.sub()‎: يبدل التابع حالات التطابق غير المتداخلة في أقصى اليسار -والناتجة عن تطبيق التعبير النمطي المصرّف على السلسلة النصية المعطاة- بسلسلة نصية أو بالقيمة المعادة من دالة.

مصادر

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