الدالة str.splitlines()‎ في بايثون

من موسوعة حسوب

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

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

b.splitlines()

المعاملات

keepends

قيمة منطقية (بوليانية).

تُدرج فواصل الأسطر في القائمة المعادة عندما يأخذ هذا المعامل القيمة 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'])

انظر أيضًا

مصادر