التابع regex.search() في بايثون
يفحص هذا التابع السلسلة النصية المعطاة بحثًا عن أول موقع يحصل فيه تطابق مع التعبير النمطي المصرّف، ويعيد كائن التطابق المقابل.
البنية العامة
regex.search(string[, pos[, endpos]])
المعاملات
string
السلسلة النصية التي ستبحث فيها الدالة عن حالات التطابق.
pos
يحدّد هذا المعامل الاختياري الموقع الذي يبدأ منه التابع البحث في السلسلة النصية، ويأخذ القيمة الافتراضية 0. إن تحديد موقع بدء عملية البحث ليس مطابقًا تمامًا لعملية تقطيع السلسلة النصية، فالمحرف '^' يطابق في بداية السلسلة النصية وفي المواقع التي تأتي بعد محرف السطر الجديد، ولكن ليس بالضرورة في الموقع الذي يبدأ التابع منه عملية البحث.
endpos
يحدّد هذا المعامل الاختياري الموقع الذي ينتهي عنده التابع من البحث في السلسة النصية، وهذا يعني أنّ عملية البحث عن التطابقات ستجري على المحارف التي تقع ضمن النطاق الذي يبدأ بالموقع pos وينتهي بالموقع endpos - 1. إن كانت قيمة endpos أقل من قيمة pos فلن يكون هناك أي حالة تطابق، وفيما عدا ذلك من الحالات، إن كان rx كائن تعبير نمطي مصرّف، فإنّ الدالة rx.search(string, 0, 50) تكافئ الدالة rx.search(string[:50], 0).
القيمة المعادة
يعيد هذا التابع كائن التطابق المقابل عند العثور على حالة تطابق، ويعيد القيمة None إن لم يحصل أي تطابق بين التعبير النمطي والسلسلة النصية، ويجب الانتباه إلى أنّ هذه الحالة تختلف عن الحالة التي تجد الدالة فيها تطابقًا طوله 0 في مكان ما من السلسلة النصية.
أمثلة
يبين المثال التالي النتائج المعادة من استخدام التابع:
>>> import re
>>> pattern = re.compile("d")
>>> pattern.search("dog") # يطابق عند الموقع 0
<_sre.SRE_Match object; span=(0, 1), match='d'>
>>> pattern.search("dog", 1) # "d" لا يوجد حالة تطابق، لأنّ عملية البحث لا تتضمن الحرف
انظر أيضًا
- الدالة
re.search(): تفحص الدالة السلسلة النصية بحثًا عن أول موقع يحصل فيه تطابق مع التعبير النمطي المعطى، وتعيد كائنmatchالمقابل.