الفرق بين المراجعتين لصفحة: «Python/bytes/splitlines»

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

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

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE:الدالة <code>str.splitlines()‎</code> في بايثون}}</noinclude>
+<noinclude>{{DISPLAYTITLE:التابع <code>str.splitlines()‎</code> في بايثون}}</noinclude>
-تقسم الدالة التسلسل الثنائي إلى [[Python/list|قائمة]] من الأسطر.
+يقسم التابع التسلسل الثنائي إلى [[Python/list|قائمة]] من الأسطر.
 == البنية العامة ==
 <syntaxhighlight lang="python3">
-b.splitlines()
+bytes.splitlines(keepends=False)</syntaxhighlight>
-</syntaxhighlight>
 == المعاملات ==
 === <code>keepends</code> ===
-[[Python/boolean|قيمة منطقية (بوليانية).]]
+[[Python/boolean|قيمة منطقية (Boolean).]]
 تُدرج فواصل الأسطر في القائمة المعادة عندما يأخذ هذا المعامل القيمة <code>True</code>.
@@ سطر 17: / سطر 16: @@
 [[Python/list|قائمة]] من الأسطر الناتجة عن تقسيم التسلسل الثنائي عند حدود الأسطر في ترميز ASCII.
-تستخدم هذه الدالة أسلوب [[https://docs.python.org/3/glossary.html#term-universal-newlines|الأسطر العامة universal newlines]] لتقسيم الأسطر.
+يستخدم هذا التابع أسلوب [https://docs.python.org/3/glossary.html#term-universal-newlines|الأسطر الأسطر الجديدة العامة universal newlines] لتقسيم الأسطر.
 == أمثلة ==
-يوضّح المثال التالي طريقة تطبيق الدالة على [[Python/str|السلاسل النصية]]:
+يوضّح المثال التالي طريقة تطبيق التابع على [[Python/str|السلاسل النصية]]:
 <syntaxhighlight lang="python3">
@@ سطر 29: / سطر 28: @@
 </syntaxhighlight>
-تختلف هذه الدالة عن الدالة <code>[[Python/bytes/split|split()]]</code>‎ في أنّها عند تعيين قيمة المعامل <code>sep</code> فإنّها تعيد [[Python/list|قائمة]] فارغة، ولا ينشأ سطر إضافي عند استخدام فاصل الأسطر في نهاية التسلسل الثنائي:
+يختلف هذا التابع عن التابع <code>[[Python/bytes/split|split()]]</code>‎ في أنّه عند تعيين قيمة المعامل <code>sep</code> فإنّه يعيد [[Python/list|قائمة]] فارغة، ولا ينشأ سطر إضافي عند استخدام فاصل الأسطر في نهاية التسلسل الثنائي:
 <syntaxhighlight lang="python3">
@@ سطر 39: / سطر 38: @@
 == انظر أيضًا ==
-* [[Python/bytes/split|الدالة bytes.split()‎ في بايثون.]]
 * [[Python/bytes|البايتات في بايثون.]]
 * [[Python/list|القوائم في بايثون.]]
+*التابع <code>[[Python/bytes/split|bytes.split()‎]]</code>: تقسيم التسلسل الثنائي إلى <nowiki/>[[Python/list|قائمة]] من تسلسلات ثنائية فرعية من النوع ذاته، بالاعتماد على فاصل محدّد.
+*التابع <code>[[Python/bytes/rsplit|bytes.rsplit()‎]]</code>: تقسيم التسلسل الثنائي إلى تسلسلات فرعية من النوع ذاته بالاعتماد على تسلسل ثنائي يحدّد الفاصل.
 == مصادر ==
 * [https://docs.python.org/3/library/stdtypes.html#bytes.splitlines قسم splitlines في صفحة Types في توثيق بايثون الرسمي.]
 [[تصنيف:Python]]
-[[تصنيف:Python Function]]
+[[تصنيف:Python Method]]
-[[تصنيف:Python Built-in Functions]]
+[[تصنيف:Python Types]]
+[[تصنيف:Python Bytes]]