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

<noinclude>{{DISPLAYTITLE:الدالة <code>re.findall()‎</code> في بايثون‎}}</noinclude>
تعيد الدالة جميع حالات التطابق غير المتداخلة للنمط المطبق على السلسلة النصية المعطاة على هيئة قائمة من السلاسل النصية. 

== البنية العامة ==
<syntaxhighlight lang="python3">
re.findall(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>findall(r'^|\w+', 'two words')‎</code> تعيد القائمة <code>‎<nowiki>['', 'wo', 'words']</nowiki>‎</code> (لاحظ عدم وجود الحرف <code><nowiki>'t'</nowiki></code>).
سيتغير هذا السلوك في الإصدار 3.7 من بايثون.

== انظر أيضًا ==
* الدالة <code>[[Python/re/finditer|re.finditer()]]‎</code>: تعيد الدالة كائنًا قابلًا للتكرار iterator ينتج عنه  [[Python/match|كائنات <code>match</code>]] لجميع حالات التطابق غير المتداخلة والناتجة من تطبيق التعبير النمطي المعطى على السلسلة النصية المعطاة.
* التابع <code>[[Python/regex/findall|regex.findall()]]</code>‎: يعيد التابع جميع حالات التطابق غير المتداخلة للنمط المصرّف والمطبّق على السلسلة النصية المعطاة على هيئة قائمة من السلاسل النصية.
* التابع <code>[[Python/regex/findall|regex.finditer()]]</code>‎: يعيد التابع كائنًا قابلًا للتكرار iterator ينتج عنه [[Python/match|كائنات <code>match</code>]] لجميع حالات التطابق غير المتداخلة والناتجة من تطبيق التعبير النمطي المصرّف على السلسلة النصية المعطاة.

== مصادر ==
* [https://docs.python.org/3/library/re.html#re.findall قسم Module Contents في صفحة Regular expressions operations في توثيق بايثون الرسمي.]
[[تصنيف:Python]]
[[تصنيف:Python Function]]
[[تصنيف:Python Regular Expressions]]
[[تصنيف:Python re]]