التابع str.splitlines()‎ في بايثون

يقسم التابع التسلسل الثنائي إلى قائمة من الأسطر.

البنية العامة

bytes.splitlines(keepends=False)

المعاملات

keepends

قيمة منطقية (Boolean).

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

القيمة المعادة

قائمة من الأسطر الناتجة عن تقسيم التسلسل الثنائي عند حدود الأسطر في ترميز ASCII.

يستخدم هذا التابع أسلوب الأسطر الجديدة العامة universal newlines لتقسيم الأسطر.

أمثلة

يوضّح المثال التالي طريقة تطبيق التابع على السلاسل النصية:

>>> 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']

يختلف هذا التابع عن التابع split()‎ في أنّه عند تعيين قيمة المعامل sep فإنّه يعيد قائمة فارغة، ولا ينشأ سطر إضافي عند استخدام فاصل الأسطر في نهاية التسلسل الثنائي:

>>> 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'])

انظر أيضًا

• البايتات في بايثون.
• القوائم في بايثون.
• التابع bytes.split()‎: تقسيم التسلسل الثنائي إلى قائمة من تسلسلات ثنائية فرعية من النوع ذاته، بالاعتماد على فاصل محدّد.

• التابع bytes.rsplit()‎: تقسيم التسلسل الثنائي إلى تسلسلات فرعية من النوع ذاته بالاعتماد على تسلسل ثنائي يحدّد الفاصل.

مصادر

• قسم splitlines في صفحة Types في توثيق بايثون الرسمي.