الدالة str.join()‎ في بايثون

تعيد الدالة join()‎ السلسلة النصية الناتجة عن ربط السلاسل النصية التابعة لكائن قابل للتكرار (iterable).

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

x.join()

المعاملات

iterable

كائن قابل للتكرار مثل الصفوف و القواميس و القوائم و السلاسل النصية و المجموعات.

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

تعيد الدالة join()‎ السلسلة النصية الناتجة عن ربط السلاسل النصية التابعة لكائن قابل للتكرار (iterable). إذا لم يكن أحد عناصر الكائن القابل للتكرار سلسلة نصية تطلق الدالة الخطأ TypeError.

أمثلة

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

>>> s = ["100", "200", "300", "400", "500"]
>>> sep = ", "
>>> sep.join(s)
'100, 200, 300, 400, 500'
>>> s1 = "abc"
>>> s2 = "123"
>>> s1.join(s2)
'1abc2abc3'
>>> s = ["100", "200", 300, "400", "500"]
>>> sep = ", "
>>> sep.join(s)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: sequence item 2: expected str instance, int found

انظر أيضًا

• السلاسل النصية في بايثون.

مصادر

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