الفرق بين المراجعتين لصفحة: «Python/re/search»
لا ملخص تعديل |
|||
| (مراجعة متوسطة واحدة بواسطة مستخدم واحد آخر غير معروضة) | |||
| سطر 32: | سطر 32: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* التابع <code>[[Python/regex/compile|regex | * التابع <code>[[Python/re/compile|regex.search()]]</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> وغيرها. | |||
== مصادر == | == مصادر == | ||
* [https://docs.python.org/3/library/re.html#re.search قسم Module Contents في صفحة Regular expressions operations في توثيق بايثون الرسمي.] | * [https://docs.python.org/3/library/re.html#re.search قسم Module Contents في صفحة Regular expressions operations في توثيق بايثون الرسمي.] | ||
* [ | * [https://docs.python.org/3/howto/regex.html صفحة Regular Expression HOWTO في توثيق بايثون الرسمي.] | ||
[[تصنيف:Python]] | [[تصنيف:Python]] | ||
[[تصنيف:Python Function]] | |||
[[تصنيف:Python Regular Expressions]] | [[تصنيف:Python Regular Expressions]] | ||
[[تصنيف:Python re]] | |||
المراجعة الحالية بتاريخ 06:38، 18 يونيو 2018
تفحص الدالة السلسلة النصية بحثًا عن أول موقع يحصل فيه تطابق مع التعبير النمطي المعطى، وتعيد كائن match المقابل.
البنية العامة
re.search(pattern, string, flags=0)
المعاملات
pattern
التعبير النمطي المستخدم لإجراء عملية المطابقة.
string
السلسلة النصية التي ستبحث فيها الدالة عن حالات التطابق.
flags
الرايات المستخدمة لضبط عملية البحث. يأخذ هذا المعامل القيمة 0 كقيمة افتراضية. راجع قسم المعاملات في توثيق الدالة ()re.compile للمزيد من المعلومات.
القيمة المعادة
تعيد الدالة كائن match عند العثور على حالة تطابق بين التعبير النمطي والسلسلة النصية المعطاة. وتعيد الدالة القيمة None إن لم تعثر على أيّ تطابق في السلسلة النصية، ويجب الانتباه إلى أنّ هذه الحالة تختلف عن الحالة التي تجد الدالة فيها تطابقًا طوله 0 في مكان ما من السلسلة النصية.
أمثلة
يبين المثال التالي طريقة استخدام الدالة والنتائج المعادة منها:
>>> print(re.search('^From', 'From Here to Eternity'))
<_sre.SRE_Match object; span=(0, 4), match='From'>
>>> print(re.search('^From', 'Reciting From Memory'))
None
انظر أيضًا
- التابع
regex.search(): يفحص هذا التابع السلسلة النصية المعطاة بحثًا عن أول موقع يحصل فيه تطابق مع التعبير النمطي المصرّف، ويعيد كائن التطابق المقابل. - الدالة
()re.compile: تصرّف الدالة التعبير النمطي إلى كائن تعبير نمطيregexيمكن استخدامه للمطابقة بواسطة توابعه الخاصّةmatch()وsearch()وغيرها.