الدالة re.fullmatch() في بايثون
تتحقّق الدالة ممّا إذا كانت السلسلة النصية بأكملها مطابقة للتعبير النمطي المعطى.
البنية العامة
re.fullmatch(pattern, string, flags=0)
المعاملات
pattern
التعبير النمطي المستخدم لإجراء عملية المطابقة.
string
السلسلة النصية التي ستبحث فيها الدالة عن حالات التطابق.
flags
الرايات المستخدمة لضبط عملية البحث. يأخذ هذا المعامل القيمة 0 كقيمة افتراضية. راجع قسم المعاملات في توثيق الدالة ()re.compile للمزيد من المعلومات.
القيمة المعادة
إن طابقت السلسلة النصية بأكملها التعبير النمطي المعطى، فستعيد الدالة كائن match المقابل، وتعيد القيمة None إن لم تطابق السلسلة النصية التعبير النمطي المعطى، ويجب الانتباه إلى أنّ هذه الحالة تختلف عن الحالة التي تجد الدالة فيها تطابقًا طوله 0.
ملاحظة: هذه الدالة متوفّرة في الإصدار 3.4 من اللغة وما بعده.
أمثلة
يبين المثال التالي طريقة استخدام الدالة والنتائج المعادة منها:
>>> print(re.fullmatch(r'From\s+', 'Fromage amk'))
None
>>> print(re.fullmatch(r'From\s+', 'From'))
None
>>> print(re.fullmatch(r'From\s+', 'From '))
<_sre.SRE_Match object; span=(0, 5), match='From '>
>>> print(re.fullmatch(r'From\s+', 'From '))
<_sre.SRE_Match object; span=(0, 8), match='From '>
انظر أيضًا
- الدالة
re.compile()في بايثون. - الدالة
re.match() في بايثون.