Python/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 من اللغة وما بعده.

مصادر

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