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

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

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

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

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

<code>string</code>

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

<code>maxsplit</code>

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

<code>flags</code>

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

== القيمة المعادة ==
تقسم الدالة السلسلة النصية عند كل مكان تحدث فيه عملية مطابقة للنمط المعطى. إن استُخدمت أقواس التقاط القيمة ضمن النمط، فإنّ النصّ التابع لجميع المجموعات ضمن النمط سيُعاد كجزء من القائمة الناتجة.

== أمثلة ==
يبين المثال التالي طريقة استخدام الدالة والنتائج المعادة منها:

<syntaxhighlight lang="python3">
>>> re.split(r'[\W]+', 'Words, words, words.')
['Words', 'words', 'words', '']
>>> re.split(r'([\W]+)', 'Words, words, words.')
['Words', ', ', 'words', ', ', 'words', '.', '']
>>> re.split(r'[\W]+', 'Words, words, words.', 1)
['Words', 'words, words.']
</syntaxhighlight>

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