عرض مصدر Python/re

<noinclude>{{DISPLAYTITLE:الوحدة re في بايثون}}</noinclude>
تقّدم الوحدة <code>re</code> مجموعة من العمليات الخاصة بمطابقة التعابير النمطية Regular Expressions وهي مشابهة إلى حدّ كبير للعمليات الموجودة في لغة Perl.

يمكن أن تكون الأنماط والسلاسل النصية المراد العثور عليها سلاسل نصية بترميز Unicode من نوع ([[Python/str|<code>str</code>]]) أو سلاسل نصية ذات 8 بتات من نوع ([[Python/bytes|<code>bytes</code>]])، ولكن لا يجوز المزج بين النوعين، بمعنى أنّه لا يمكن مطابقة سلسلة نصية مع نمط من نوع البايتات والعكس صحيح أيضًا، وبنفس الطريقة، عند الرغبة في إجراء عملية استبدال يجب أن تكون سلسلة الاستبدال النصية من نوع واحد يطابق نوع كلّ من النمط وسلسلة البحث النصية.

تستخدم التعابير النمطية المحرف (<code>'\'</code>) للإشارة إلى أشكال خاصة من الأنماط أو للسماح باستخدام الحروف الخاصة كما هي ودون تنفيذ وظيفته الخاصة، وتستخدم بايثون المحرف ذاته لأداء الوظيفة عينها في السلاسل النصية، الأمر الذي يؤدي إلى حدوث بعض الأخطاء، فعلى سبيل المثال لمطابقة الخط المائل العكسي يجب استخدام النمط <code>'\\\\'</code>، وذلك لأنّ التعبير النمطي يجب أن يكون <code>'\\'</code>، وفي الوقت ذاته يجب تمثيل كل خط مائل عكسي في السلاسل النصية الاعتيادية باستخدام <code>'\\'</code>.

ولحل مشكلة التضارب هذه يمكن استخدام السلاسل النصية الخام في بايثون، وهي السلاسل النصية التي تكون مسبوقة بالحرف <code>r</code>. لا تُعامل الخطوط المائلة العكسية في السلاسل النصية الخام معاملة خاصة، لذا فإنّ التعبير <code>r"\n"‎</code> هو سلسلة نصية تتضمن حرفين هما <code>'\'</code> و <code>'n'</code>، أما التعبير ‎<code>"\n"</code>‎ فهو سلسلة نصية تتضمن حرفًا واحدًا هو حرف السطر الجديد، ومن هنا اعتاد المطوّرون على استخدام السلاسل النصية الخام لكتابة الأنماط المستخدمة في التعابير النمطية.

من الضروري الانتباه إلى أنّ معظم العمليات الخاصة بالتعابير النمطية متوفّرة كدوالّ على مستوى الوحدة module-level functions ويمكن تطبيقها على التعابير النمطية المصرّفة. والدوالّ هي اختصارات لا تتطلب إجراء عملية التصريف على [[Python/regex|كائن <code>regex</code>]] في البداية، ولكنّها تفتقد بعض المعاملات التي تضبط أداء هذه الدوال.
==دوال الوحدة <code>re</code>==
تقدّم الوحدة <code>re</code> مجموعة الدوال التالية:
===الدالة <code rel="mw:WikiLink" title="Python/re/compile" href="Python/re/compile">[[Python/re/compile|re.compile()]]‎</code>===
تصرّف الدالة التعبير النمطي إلى [[Python/regex|كائن تعبير نمطي <code>regex</code>]] يمكن استخدامه للمطابقة بواسطة توابعه الخاصّة <code>[[Python/regex/match|match()‎]]</code> و <code>[[Python/regex/search|search()]]‎</code> وغيرها.
===الدالة [[Python/re/search|<code>re.search()</code>]]‎===
تفحص الدالة السلسلة النصية بحثًا عن أول موقع يحصل فيه تطابق مع التعبير النمطي المعطى، وتعيد [[Python/match|كائن <code>match</code>]] المقابل.
===الدالة [[Python/re/match|<code>re.match()</code>]]‎===
تفحص الدالة بداية السلسلة النصية بحثًا عن حالة تطابق مع التعبير النمطي المعطى، وتعيد  [[Python/match|كائن <code>match</code>]] المقابل.
=====الدالة [[Python/re/fullmatch|<code>re.fullmatch()</code>]]‎=====
تتحقّق الدالة ممّا إذا كانت السلسلة النصية بأكملها مطابقة للتعبير النمطي المعطى.
=====الدالة [[Python/re/split|<code>re.split()</code>]]‎=====
تقسم الدالة السلسلة النصية عند كل مكان تحدث فيه عملية مطابقة للنمط المعطى.
=====الدالة [[Python/re/findall|<code>re.findall()</code>]]‎=====
تعيد الدالة جميع حالات التطابق غير المتداخلة للنمط المطبق على السلسلة النصية المعطاة على هيئة قائمة من السلاسل النصية.
=====الدالة [[Python/re/finditer|<code>re.findeiter()</code>‎]]=====
تعيد الدالة كائنًا قابلًا للتكرار iterator ينتج عنه  [[Python/match|كائنات <code>match</code>]] لجميع حالات التطابق غير المتداخلة والناتجة من تطبيق التعبير النمطي المعطى على السلسلة النصية المعطاة.
=====الدالة [[Python/re/sub|<code>re.sub()</code>]]‎=====
تبدل الدالة حالات التطابق غير المتداخلة في أقصى اليسار -والناتجة عن تطبيق التعبير النمطي المعطى على السلسلة النصية المعطاة- بسلسلة نصية أو بالقيمة المعادة من دالة.
=====الدالة [[Python/re/subn|<code>re.subn()</code>]]‎=====
تؤدي هذه الدالة نفس عمل الدالة <code>[[Python/re/sub|re.sub()‎]]</code> ولكنّها تعيد الناتج على هيئة <nowiki/>[[Python/tuples|صفّ]] (السلسلة الجديدة، عدد الاستبدالات المجراة).
=====الدالة [[Python/re/escape|<code>re.escape()</code>]]‎=====
تهرّب الدالة جميع المحارف الخاصّة في التعبير النمطي المعطى باستثناء حروف الترميز ASCII، والأعداد والشرطة السفلية.

=== الدالة <code>[[Python/re/purge|re.purge()‎]]</code> ===
تفرغ هذه الدالة الذاكرة المخبئية cache الخاصة بالتعبير النظامي.

== استثناءات الوحدة <code>re</code> ==
تقدّم الوحدة استثناء واحدًا فقط وهو:

=====الاستثناء [[Python/re/error|<code>re.error()</code>‎]]=====
تطلق اللغة هذا الاستثناء عند تمرير سلسلة نصية غير صالحة كتعبير نمطي إلى إحدى الدوال السابقة (كأن تتضمن السلسلة أقواسًا غير متطابقة)، أو عند حدوث أخطاء أخرى أثناء عملية التصريف أو المطابقة. لا يعد خلوّ السلسلة النصية من التطابقات خطأً على الإطلاق.

== مصادر ==
* [https://docs.python.org/3/library/re.html#module-re صفحة Regular expression operations في توثيق بايثون الرسمي.]