Python/regex/fullmatch

يتحقّق هذا التابع من تطابق التعبير النمطي المصرّف مع السلسلة النصية المعطاة كاملة، ويعيد كائن التطابق المقابل.

البنية العامة

regex.fullmatch(string[, pos[, endpos]])

المعاملات

string

السلسلة النصية التي ستبحث فيها الدالة عن حالات التطابق.

pos

يحدّد هذا المعامل الاختياري الموقع الذي يبدأ منه التابع البحث في السلسلة النصية، ويأخذ القيمة الافتراضية 0. إن تحديد موقع بدء عملية البحث ليس مطابقًا تمامًا لعملية تقطيع السلسلة النصية، فالمحرف '^' يطابق في بداية السلسلة النصية وفي المواقع التي تأتي بعد محرف السطر الجديد، ولكن ليس بالضرورة في الموقع الذي يبدأ التابع منه عملية البحث.

endpos

يحدّد هذا المعامل الاختياري الموقع الذي ينتهي عنده التابع من البحث في السلسة النصية، وهذا يعني أنّ عملية البحث عن التطابقات ستجري على المحارف التي تقع ضمن النطاق الذي يبدأ بالموقع pos وينتهي بالموقع endpos - 1. إن كانت قيمة endpos أقل من قيمة pos فلن يكون هناك أي حالة تطابق.

القيمة المعادة

إن طابقت السلسلة النصية بأكملها التعبير النمطي المعطى، فسيعيد التابع كائن match المقابل، وسيعيد القيمة None إن لم تطابق السلسلة النصية التعبير النمطي المعطى، ويجب الانتباه إلى أنّ هذه الحالة تختلف عن الحالة التي تجد الدالة فيها تطابقًا طوله 0.

ملاحظة: هذه الدالة متوفّرة في الإصدار 3.4 من اللغة وما بعده.

أمثلة

في المثال التالي لا توجد حالة تطابق مع السلسلة "dog" لأنّ الحرف "o" لم يرد في بداية الكلمة، ولا يوجد تطابق في مع السلسلة "ogre" لأنّها لا تطابق بأكملها التعبير النمطي المعطى، ولكن تظهر حالة تطابق ضمن الحدود التي جرى تعيينها بتمرير القيم 1 و 3 إلى المعاملين pos و endpos على التوالي.

>>> pattern = re.compile("o[gh]")
>>> pattern.fullmatch("dog")
>>> pattern.fullmatch("ogre")
>>> pattern.fullmatch("doggie", 1, 3)
<_sre.SRE_Match object; span=(1, 3), match='og'>

انظر أيضًا

• الدالة re.fullmatch()‎ في بايثون.

مصادر

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