عرض مصدر Python/re/search

<noinclude>{{DISPLAYTITLE:الدالة <code>re.search()‎</code> في بايثون‎}}</noinclude>
تفحص الدالة السلسلة النصية بحثًا عن أول موقع يحصل فيه تطابق مع التعبير النمطي المعطى، وتعيد كائن <code>match</code> المقابل.

== البنية العامة ==
<syntaxhighlight lang="python3">
re.search(pattern, string, flags=0)
</syntaxhighlight>

== المعاملات ==
<code>pattern</code>

التعبير النمطي المستخدم لإجراء عملية المطابقة.

<code>string</code>

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

<code>flags</code>

الرايات المستخدمة لضبط عملية البحث. يأخذ هذا المعامل القيمة <code>0</code> كقيمة افتراضية. راجع قسم المعاملات في توثيق الدالة <code>[[Python/re/compile|()re.compile]]</code> للمزيد من المعلومات.

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

== أمثلة ==
يبين المثال التالي طريقة استخدام الدالة والنتائج المعادة منها:<syntaxhighlight lang="python3">
>>> 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
</syntaxhighlight>

== انظر أيضًا ==
* التابع <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/howto/regex.html صفحة Regular Expression HOWTO في توثيق بايثون الرسمي.]
[[تصنيف:Python]]
[[تصنيف:Python Function]]
[[تصنيف:Python Regular Expressions]]
[[تصنيف:Python re]]