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

من موسوعة حسوب
< Python‏ | bytes

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

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

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.rsplit()‎: تقسيم التسلسل الثنائي إلى تسلسلات فرعية من النوع ذاته بالاعتماد على تسلسل ثنائي يحدّد الفاصل.

مصادر