الدالة 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'])

انظر أيضًا

• الدالة bytes.split()‎ في بايثون.
• البايتات في بايثون.
• القوائم في بايثون.

مصادر

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