الفرق بين المراجعتين لصفحة: «Python/bytes/splitlines»
لا ملخص تعديل |
|||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الدالة <code>str.splitlines()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:الدالة <code>str.splitlines()</code> في بايثون}}</noinclude> | ||
يقسم التابع التسلسل الثنائي إلى [[Python/list|قائمة]] من الأسطر. | |||
== البنية العامة == | == البنية العامة == | ||
| سطر 10: | سطر 10: | ||
=== <code>keepends</code> === | === <code>keepends</code> === | ||
[[Python/boolean|قيمة منطقية ( | [[Python/boolean|قيمة منطقية (Boolean).]] | ||
تُدرج فواصل الأسطر في القائمة المعادة عندما يأخذ هذا المعامل القيمة <code>True</code>. | تُدرج فواصل الأسطر في القائمة المعادة عندما يأخذ هذا المعامل القيمة <code>True</code>. | ||
| سطر 17: | سطر 17: | ||
[[Python/list|قائمة]] من الأسطر الناتجة عن تقسيم التسلسل الثنائي عند حدود الأسطر في ترميز ASCII. | [[Python/list|قائمة]] من الأسطر الناتجة عن تقسيم التسلسل الثنائي عند حدود الأسطر في ترميز ASCII. | ||
يستخدم هذا التابع أسلوب [https://docs.python.org/3/glossary.html#term-universal-newlines|الأسطر الأسطر الجديدة العامة universal newlines] لتقسيم الأسطر. | |||
== أمثلة == | == أمثلة == | ||
يوضّح المثال التالي طريقة تطبيق | يوضّح المثال التالي طريقة تطبيق التابع على [[Python/str|السلاسل النصية]]: | ||
<syntaxhighlight lang="python3"> | <syntaxhighlight lang="python3"> | ||
| سطر 29: | سطر 29: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
يختلف هذا التابع عن التابع <code>[[Python/bytes/split|split()]]</code> في أنّه عند تعيين قيمة المعامل <code>sep</code> فإنّه يعيد [[Python/list|قائمة]] فارغة، ولا ينشأ سطر إضافي عند استخدام فاصل الأسطر في نهاية التسلسل الثنائي: | |||
<syntaxhighlight lang="python3"> | <syntaxhighlight lang="python3"> | ||
| سطر 39: | سطر 39: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* [[Python/bytes|البايتات في بايثون.]] | * [[Python/bytes|البايتات في بايثون.]] | ||
* [[Python/list|القوائم في بايثون.]] | * [[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 في توثيق بايثون الرسمي.] | * [https://docs.python.org/3/library/stdtypes.html#bytes.splitlines قسم splitlines في صفحة Types في توثيق بايثون الرسمي.] | ||
مراجعة 10:23، 9 يونيو 2018
يقسم التابع التسلسل الثنائي إلى قائمة من الأسطر.
البنية العامة
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(): تقسيم التسلسل الثنائي إلى قائمة من تسلسلات ثنائية فرعية من النوع ذاته، بالاعتماد على فاصل محدّد.
- التابع
bytes.rsplit(): تقسيم التسلسل الثنائي إلى تسلسلات فرعية من النوع ذاته بالاعتماد على تسلسل ثنائي يحدّد الفاصل.