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

من موسوعة حسوب
< Python‏ | bytes
مراجعة 11:59، 10 يونيو 2018 بواسطة عبد اللطيف ايمش (نقاش | مساهمات) (استبدال النص - ':الدالة' ب':التابع')
(فرق) → مراجعة أقدم | المراجعة الحالية (فرق) | مراجعة أحدث ← (فرق)

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

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

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

مصادر