الفرق بين المراجعتين ل"Python/bytes/split"
ط (←انظر أيضًا) |
|||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الدالة <code>bytes.split()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:الدالة <code>bytes.split()</code> في بايثون}}</noinclude> | ||
| − | + | يقسم التابع التسلسل الثنائي إلى [[Python/list|قائمة]] من تسلسلات ثنائية فرعية من النوع ذاته، بالاعتماد على فاصل محدّد. | |
==البنية العامة== | ==البنية العامة== | ||
| سطر 8: | سطر 8: | ||
==المعاملات== | ==المعاملات== | ||
===<code>maxsplit</code>=== | ===<code>maxsplit</code>=== | ||
| − | يحدد هذا المعامل الحد الأقصى لعمليات | + | يحدد هذا المعامل الحد الأقصى لعمليات التقسيم التي سيجريها التابع، وبهذا تمتلك القائمة المعادة <code>maxsplit+1</code> من العناصر على الأكثر. في حال عدم تحديد قيمة المعامل <code>maxsplit</code> أو كانت قيمته <code>-1</code>، فلن يكون هناك حدّ لعمليات التقسيم (ستجري الدالة جميع عمليات التقسيم الممكنة). |
===<code>sep</code>=== | ===<code>sep</code>=== | ||
| − | يحدّد هذا المعامل الفاصل الذي | + | يحدّد هذا المعامل الفاصل الذي سيعتمده التابع في تقسيم السلسلة النصية. في حال تحديد قيمة هذا المعامل لن تُجمّع الفواصل المتتابعة مع بعضها البعض وستعدّ فواصل لتسلسلات ثنائية فارغة. |
يمكن أن يتكوّن المعامل <code>sep</code> من تسلسل بايتات متعددة. | يمكن أن يتكوّن المعامل <code>sep</code> من تسلسل بايتات متعددة. | ||
==القيمة المعادة== | ==القيمة المعادة== | ||
| − | + | يعيد التابع [[Python/list|قائمة]] من التسلسلات الفرعية. | |
| − | يؤدي تطبيق | + | يؤدي تطبيق التابع <code>split()</code> على تسلسل ثنائي فارغ إلى إعادة القيمة <code>[<nowiki>''</nowiki>b]</code> أو القيمة <code>[bytearray(b<nowiki>''</nowiki>)]</code>وذلك بحسب نوع الكائن الذي يجري تقسيمه. |
| − | في حال عدم تحديد قيمة المعامل <code>sep</code> أو إعطائه القيمة <code>None</code>، | + | في حال عدم تحديد قيمة المعامل <code>sep</code> أو إعطائه القيمة <code>None</code>، سيُنفّذ التابع الخوارزمية التالية لإجراء عملية التقسيم: |
تعدّ مجموعة من المسافات البيضاء بمثابة فاصل واحد، وتكون النتيجة المعادة خالية من السلاسل الفارغة في البداية أو في النهاية إن كانت السلاسل الأصلية تتضمن مسافات بيضاء في نهايتها أو بدايتها. | تعدّ مجموعة من المسافات البيضاء بمثابة فاصل واحد، وتكون النتيجة المعادة خالية من السلاسل الفارغة في البداية أو في النهاية إن كانت السلاسل الأصلية تتضمن مسافات بيضاء في نهايتها أو بدايتها. | ||
| سطر 24: | سطر 24: | ||
وبناء على ذلك فإنّ نتيجة تقسيم تسلسل فارغ أو تسلسل يتضمن مسافات بيضاء بترميز ASCII فقط باستخدام الفاصل <code>None</code> هي [[Python/list|قائمة فارغة]] <code>[]</code>. | وبناء على ذلك فإنّ نتيجة تقسيم تسلسل فارغ أو تسلسل يتضمن مسافات بيضاء بترميز ASCII فقط باستخدام الفاصل <code>None</code> هي [[Python/list|قائمة فارغة]] <code>[]</code>. | ||
==أمثلة== | ==أمثلة== | ||
| − | يوضّح المثال التالي | + | يوضّح المثال التالي طرائق مختلفة لاستخدام التابع <code>split()</code> والنتائج المعادة منها:<syntaxhighlight lang="python3"> |
>>> b'1,2,3'.split(b',') | >>> b'1,2,3'.split(b',') | ||
[b'1', b'2', b'3'] | [b'1', b'2', b'3'] | ||
| سطر 41: | سطر 41: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
| − | *[[Python/bytes | + | * [[Python/bytes|البايتات في بايثون.]] |
| − | *[[Python/ | + | * [[Python/list|القوائم في بايثون.]] |
| − | *[[Python/ | + | * التابع <code>[[Python/bytes/rsplit|bytes.rsplit()]]</code>: تقسيم التسلسل الثنائي إلى تسلسلات فرعية من النوع ذاته بالاعتماد على تسلسل ثنائي يحدّد الفاصل. |
==مصادر== | ==مصادر== | ||
| − | |||
*[https://docs.python.org/3/library/stdtypes.html#bytes.split قسم split في صفحة Types في توثيق بايثون الرسمي.] | *[https://docs.python.org/3/library/stdtypes.html#bytes.split قسم split في صفحة Types في توثيق بايثون الرسمي.] | ||
مراجعة 08:20، 9 يونيو 2018
يقسم التابع التسلسل الثنائي إلى قائمة من تسلسلات ثنائية فرعية من النوع ذاته، بالاعتماد على فاصل محدّد.
البنية العامة
b.split()
المعاملات
maxsplit
يحدد هذا المعامل الحد الأقصى لعمليات التقسيم التي سيجريها التابع، وبهذا تمتلك القائمة المعادة maxsplit+1 من العناصر على الأكثر. في حال عدم تحديد قيمة المعامل maxsplit أو كانت قيمته -1، فلن يكون هناك حدّ لعمليات التقسيم (ستجري الدالة جميع عمليات التقسيم الممكنة).
sep
يحدّد هذا المعامل الفاصل الذي سيعتمده التابع في تقسيم السلسلة النصية. في حال تحديد قيمة هذا المعامل لن تُجمّع الفواصل المتتابعة مع بعضها البعض وستعدّ فواصل لتسلسلات ثنائية فارغة.
يمكن أن يتكوّن المعامل sep من تسلسل بايتات متعددة.
القيمة المعادة
يعيد التابع قائمة من التسلسلات الفرعية.
يؤدي تطبيق التابع split() على تسلسل ثنائي فارغ إلى إعادة القيمة [''b] أو القيمة [bytearray(b'')]وذلك بحسب نوع الكائن الذي يجري تقسيمه.
في حال عدم تحديد قيمة المعامل sep أو إعطائه القيمة None، سيُنفّذ التابع الخوارزمية التالية لإجراء عملية التقسيم:
تعدّ مجموعة من المسافات البيضاء بمثابة فاصل واحد، وتكون النتيجة المعادة خالية من السلاسل الفارغة في البداية أو في النهاية إن كانت السلاسل الأصلية تتضمن مسافات بيضاء في نهايتها أو بدايتها.
وبناء على ذلك فإنّ نتيجة تقسيم تسلسل فارغ أو تسلسل يتضمن مسافات بيضاء بترميز ASCII فقط باستخدام الفاصل None هي قائمة فارغة [].
أمثلة
يوضّح المثال التالي طرائق مختلفة لاستخدام التابع split() والنتائج المعادة منها:
>>> b'1,2,3'.split(b',')
[b'1', b'2', b'3']
>>> b'1,2,3'.split(b',', maxsplit=1)
[b'1', b'2,3']
>>> b'1,2,,3,'.split(b',')
[b'1', b'2', b'', b'3', b'']
>>> b'1<>2<>3'.split(b'<>')
b'1', b'2', b'3']
>>> b'1 2 3'.split()
[b'1', b'2', b'3']
>>> b'1 2 3'.split(maxsplit=1)
[b'1', b'2 3']
>>> b' 1 2 3 '.split()
[b'1', b'2', b'3']
انظر أيضًا
- البايتات في بايثون.
- القوائم في بايثون.
- التابع
bytes.rsplit(): تقسيم التسلسل الثنائي إلى تسلسلات فرعية من النوع ذاته بالاعتماد على تسلسل ثنائي يحدّد الفاصل.