عرض مصدر Python/bytes/splitlines

<noinclude>{{DISPLAYTITLE:الدالة <code>str.splitlines()‎</code> في بايثون}}</noinclude>
يقسم التابع التسلسل الثنائي إلى [[Python/list|قائمة]] من الأسطر.

== البنية العامة ==
<syntaxhighlight lang="python3">
b.splitlines()
</syntaxhighlight>

== المعاملات ==

=== <code>keepends</code> ===
[[Python/boolean|قيمة منطقية (Boolean).]]

تُدرج فواصل الأسطر في القائمة المعادة عندما يأخذ هذا المعامل القيمة <code>True</code>.

== القيمة المعادة ==
[[Python/list|قائمة]] من الأسطر الناتجة عن تقسيم التسلسل الثنائي عند حدود الأسطر في ترميز ASCII. 

يستخدم هذا التابع أسلوب [https://docs.python.org/3/glossary.html#term-universal-newlines|الأسطر الأسطر الجديدة العامة universal newlines] لتقسيم الأسطر.

== أمثلة ==
يوضّح المثال التالي طريقة تطبيق التابع على [[Python/str|السلاسل النصية]]:

<syntaxhighlight lang="python3">
>>> b'ab c\n\nde fg\rkl\r\n'.splitlines()
[b'ab c', b'', b'de fg', b'kl']
>>> b'ab c\n\nde fg\rkl\r\n'.splitlines(keepends=True)
[b'ab c\n', b'\n', b'de fg\r', b'kl\r\n']
</syntaxhighlight>

يختلف هذا التابع عن التابع <code>[[Python/bytes/split|split()]]</code>‎ في أنّه عند تعيين قيمة المعامل <code>sep</code> فإنّه يعيد [[Python/list|قائمة]] فارغة، ولا ينشأ سطر إضافي عند استخدام فاصل الأسطر في نهاية التسلسل الثنائي:

<syntaxhighlight lang="python3">
>>> b"".split(b'\n'), b"Two lines\n".split(b'\n')
([b''], [b'Two lines', b''])
>>> b"".splitlines(), b"One line\n".splitlines()
([], [b'One line'])
</syntaxhighlight>

== انظر أيضًا ==
* [[Python/bytes|البايتات في بايثون.]]
* [[Python/list|القوائم في بايثون.]]
*التابع <code>[[Python/bytes/split|bytes.split()‎]]</code>: تقسيم التسلسل الثنائي إلى <nowiki/>[[Python/list|قائمة]] من تسلسلات ثنائية فرعية من النوع ذاته، بالاعتماد على فاصل محدّد.

*التابع <code>[[Python/bytes/rsplit|bytes.rsplit()‎]]</code>: تقسيم التسلسل الثنائي إلى تسلسلات فرعية من النوع ذاته بالاعتماد على تسلسل ثنائي يحدّد الفاصل.
== مصادر ==
* [https://docs.python.org/3/library/stdtypes.html#bytes.splitlines قسم splitlines في صفحة Types في توثيق بايثون الرسمي.]
[[تصنيف:Python]]
[[تصنيف:Python Method]]
[[تصنيف:Python Types]]
[[تصنيف:Python Bytes]]