عرض مصدر Python/bytes/partition

<noinclude>{{DISPLAYTITLE:الدالة <code>bytes.partition()‎</code> في بايثون}}</noinclude>
تقسم هذه الدالة التسلسل عند أول ظهور للقيمة التي يحدّدها المستخدم.

== البنية العامة ==
<syntaxhighlight lang="python3">
b.partition()
</syntaxhighlight>

== المعاملات ==

=== <code>sep</code> ===

يحدّد هذا المعامل الفاصل الذي سيعتمده التابع في تقسيم التسلسل.

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

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

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

<syntaxhighlight lang="python3">
>>> seq = b"Python Programming Language"
>>> seq.partition(b" ")
(b'Python', b' ', b'Programming Language')
>>> seq.partition(b", ")
(b'Python Programming Language', b'', b'')
</syntaxhighlight>

== انظر أيضًا ==
* [[Python/bytes/rpartition|الدالة bytes.rpartition()‎ في بايثون.]]
* [[Python/bytes|البايتات في بايثون.]]
* [[Python/bytearray|مصفوفات البايتات في بايثون.]]

== مصادر ==
* [https://docs.python.org/3/library/stdtypes.html#bytes.partition قسم partition في صفحة Types في توثيق بايثون الرسمي.]
[[تصنيف:Python]]
[[تصنيف:Python Function]]
[[تصنيف:Python Built-in Functions]]