الفرق بين المراجعتين لصفحة: «Python/bytes/partition»
ط ←sep |
لا ملخص تعديل |
||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الدالة <code>bytes.partition()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:الدالة <code>bytes.partition()</code> في بايثون}}</noinclude> | ||
يقسم هذا التابع التسلسل عند أول ظهور للقيمة التي يحدّدها المستخدم. | |||
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="python3"> | <syntaxhighlight lang="python3"> | ||
str.partition(sep) | |||
</syntaxhighlight> | </syntaxhighlight> | ||
سطر 14: | سطر 14: | ||
== القيمة المعادة == | == القيمة المعادة == | ||
تعيد هذه الدالة [[Python/tuples | صفًّا]] مكوّنًا من ثلاثة عناصر، الأول هو جزء التسلسل الذي يسبق الفاصل، والثاني هو الفاصل نفسه أو نسخة عنه من نوع مصفوفة البايتات، والثالث هو الجزء الذي يلي الفاصل. | تعيد هذه الدالة [[Python/tuples |صفًّا]] مكوّنًا من ثلاثة عناصر، الأول هو جزء التسلسل الذي يسبق الفاصل، والثاني هو الفاصل نفسه أو نسخة عنه من نوع مصفوفة البايتات، والثالث هو الجزء الذي يلي الفاصل. | ||
في حال عدم العثور على الفاصل | في حال عدم العثور على الفاصل يعيد التابع صفًّا مكوّنًا من ثلاثة عناصر، الأوّل هو نسخة عن التسلسل الأصلي، يليه كائنان فارغان من نوع [[Python/bytes|البايت]] أو [[Python/bytearray|مصفوفة البايت]]. | ||
== أمثلة == | == أمثلة == | ||
يبين المثال التالي النتائج المعادة من تطبيق | يبين المثال التالي النتائج المعادة من تطبيق التابع على سلاسل نصية مختلفة: | ||
<syntaxhighlight lang="python3"> | <syntaxhighlight lang="python3"> | ||
سطر 30: | سطر 30: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* [[Python/bytes|البايتات في بايثون.]] | * [[Python/bytes|البايتات في بايثون.]] | ||
* [[Python/bytearray|مصفوفات البايتات في بايثون.]] | * [[Python/bytearray|مصفوفات البايتات في بايثون.]] | ||
*التابع <code>[[Python/bytes/rpartition|bytes.rpartition()]]</code>: تقسيم البيانات الثنائية عند آخر ظهور للقيمة التي يحدّدها المستخدم. | |||
== مصادر == | == مصادر == |
مراجعة 07:25، 9 يونيو 2018
يقسم هذا التابع التسلسل عند أول ظهور للقيمة التي يحدّدها المستخدم.
البنية العامة
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()
: تقسيم البيانات الثنائية عند آخر ظهور للقيمة التي يحدّدها المستخدم.