الدالة re.escape() في بايثون
تهرّب الدالة جميع المحارف الخاصّة في التعبير النمطي المعطى باستثناء حروف الترميز ASCII، والأعداد والشرطة السفلية.
البنية العامة
re.escape(pattern)
المعاملات
pattern
التعبير النمطي الذي تهرّب الدالة محارفه الخاصة.
القيمة المعادة
تعيد الدالة النمط الأصلي بعد تهريب جميع المحارف الخاصّة فيه باستثناء حروف الترميز ASCII، والأعداد والشرطة السفلية. هذه الدالة مفيدة عند الحاجة إلى مطابقة سلسلة نصية يحتمل أن تتضمن بعض الحروف الخاصّة بالتعابير النمطية.
أمثلة
تبيّن الأمثلة التالية طرق استخدام الدالة re.escape():
>>> print(re.escape('python.exe'))
python\.exe
>>> legal_chars = string.ascii_lowercase + string.digits + "!#$%&'*+-.^_`|~:"
>>> print('[%s]+' % re.escape(legal_chars))
[abcdefghijklmnopqrstuvwxyz0123456789\!\#\$\%\&\'\*\+\-\.\^_\`\|\~\:]+
>>> operators = ['+', '-', '*', '/', '**']
>>> print('|'.join(map(re.escape, sorted(operators, reverse=True))))
\/|\-|\+|\*\*|\*
لا يجوز استخدام هذه الدالة كسلسلة استبدال في الدالتين re.sub() و re.subn()، ويجب تهريب الخطوط المائلة العكسية فقط. فمثلًا:
>>> digits_re = r'\d+'
>>> sample = '/usr/sbin/sendmail - 0 errors, 12 warnings'
>>> print(re.sub(digits_re, digits_re.replace('\\', r'\\'), sample))
/usr/sbin/sendmail - \d+ errors, \d+ warnings
ملاحظة: لن تهرّب الشرطة السفلية '_' في الإصدار 3.3 من اللغة وما بعده.