الفرق بين المراجعتين لصفحة: «Python/re/fullmatch»

المراجعة الحالية بتاريخ 06:42، 18 يونيو 2018

تتحقّق الدالة ممّا إذا كانت السلسلة النصية بأكملها مطابقة للتعبير النمطي المعطى.

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

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    '>

انظر أيضًا

التابع regex.fullmatch()‎: يتحقّق هذا التابع من تطابق التعبير النمطي المصرّف مع السلسلة النصية المعطاة كاملة، ويعيد كائن التطابق المقابل.
الدالة : re.match()‎: تفحص الدالة بداية السلسلة النصية بحثًا عن حالة تطابق مع التعبير النمطي المعطى، وتعيد كائن match المقابل.
الدالة re.compile()‎: تصرّف الدالة التعبير النمطي إلى كائن تعبير نمطي regex يمكن استخدامه للمطابقة بواسطة توابعه الخاصّة match()‎ و search()‎ وغيرها..
الدالة re.search()‎: تفحص الدالة السلسلة النصية بحثًا عن أول موقع يحصل فيه تطابق مع التعبير النمطي المعطى، وتعيد كائن match المقابل.

مصادر

@@ سطر 22: / سطر 22: @@
 == القيمة المعادة ==
 إن طابقت السلسلة النصية بأكملها التعبير النمطي المعطى، فستعيد الدالة كائن <code>match</code> المقابل، وتعيد القيمة <code>None</code> إن لم تطابق السلسلة النصية التعبير النمطي المعطى، ويجب الانتباه إلى أنّ هذه الحالة تختلف عن الحالة التي تجد الدالة فيها تطابقًا طوله 0.
 ملاحظة: هذه الدالة متوفّرة في الإصدار 3.4 من اللغة وما بعده.
@@ سطر 39: / سطر 40: @@
 == انظر أيضًا ==
-* الدالة <code>[[Python/re/compile|re.compile()]]‎</code> في بايثون.
+* التابع <code>[[Python/regex/fullmatch|regex.fullmatch()]]</code>‎: يتحقّق هذا التابع من تطابق التعبير النمطي المصرّف مع السلسلة النصية المعطاة كاملة، ويعيد كائن التطابق المقابل.
-* الدالة <code>[[Python/re/match|re.match()]]</code>‎ في بايثون.
+* الدالة : <code>[[Python/re/compile|re.match()]]‎</code>: تفحص الدالة بداية السلسلة النصية بحثًا عن حالة تطابق مع التعبير النمطي المعطى، وتعيد  [[Python/match|كائن <code>match</code>]] المقابل.
+* الدالة <code>[[Python/re/compile|re.compile()]]‎</code>: تصرّف الدالة التعبير النمطي إلى [[Python/regex|كائن تعبير نمطي <code>regex</code>]] يمكن استخدامه للمطابقة بواسطة توابعه الخاصّة <code>[[Python/regex/match|match()‎]]</code> و <code>[[Python/regex/search|search()]]‎</code> وغيرها..
+* الدالة <code>[[Python/re/search|re.search()]]</code>‎: تفحص الدالة السلسلة النصية بحثًا عن أول موقع يحصل فيه تطابق مع التعبير النمطي المعطى، وتعيد [[Python/match|كائن <code>match</code>]] المقابل.
 == مصادر ==
 * [https://docs.python.org/3/library/re.html#re.fullmatch قسم Module Contents في صفحة Regular expressions operations في توثيق بايثون الرسمي.]
-* [[صفحة Regular Expression HOWTO في توثيق بايثون الرسمي.]]
+* [https://docs.python.org/3/howto/regex.html صفحة Regular Expression HOWTO في توثيق بايثون الرسمي.]
 [[تصنيف:Python]]
+[[تصنيف:Python Function]]
 [[تصنيف:Python Regular Expressions]]
+[[تصنيف:Python re]]