Python/bytes/partition

يقسم هذا التابع التسلسل عند أول ظهور للقيمة التي يحدّدها المستخدم.

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

str.partition(sep)

المعاملات

sep

كائن شبيه بالبايتات (bytes-like object) يحدّد الفاصل الذي ستعتمده الدالة في تقسيم التسلسل.

القيمة المعادة

تعيد هذه الدالة صفًّا مكوّنًا من ثلاثة عناصر، الأول هو جزء التسلسل الذي يسبق الفاصل، والثاني هو الفاصل نفسه أو نسخة عنه من نوع مصفوفة البايتات، والثالث هو الجزء الذي يلي الفاصل.

في حال عدم العثور على الفاصل يعيد التابع صفًّا مكوّنًا من ثلاثة عناصر، الأوّل هو نسخة عن التسلسل الأصلي، يليه كائنان فارغان من نوع البايت أو مصفوفة البايت.

أمثلة

يبين المثال التالي النتائج المعادة من تطبيق التابع على سلاسل نصية مختلفة:

>>> seq = b"Python Programming Language"
>>> seq.partition(b" ")
(b'Python', b' ', b'Programming Language')
>>> seq.partition(b", ")
(b'Python Programming Language', b'', b'')

انظر أيضًا

• البايتات في بايثون.
• مصفوفات البايتات في بايثون.
• التابع bytes.rpartition()‎: تقسيم البيانات الثنائية عند آخر ظهور للقيمة التي يحدّدها المستخدم.

مصادر

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