Python/str/partition

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

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

x.partition()

المعاملات

sep

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

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

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

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

أمثلة

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

>>> str = "Python in Hsoub Wiki"
>>> str.partition("in ")
('Python ', 'in ', 'Hsoub Wiki')
>>> str.partition("out ")
('Python in Hsoub Wiki', '', '')
>>> str = "String methods in Python in Hsoub Wiki"
>>> str.partition("in ")
('String methods ', 'in ', 'Python in Hsoub Wiki')

انظر أيضًا

• الدالة str.rpartition()‎ في بايثون.
• السلاسل النصية في بايثون.

مصادر

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