عرض مصدر Python/str/join

<noinclude>{{DISPLAYTITLE:الدالة <code>str.join()‎</code> في بايثون}}</noinclude>
تعيد الدالة <code>join()‎</code> السلسلة النصية الناتجة عن ربط السلاسل النصية التابعة لكائن قابل للتكرار (iterable). 

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

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

=== <code>iterable</code> ===

كائن قابل للتكرار مثل [[Python/tupel| الصفوف]] و[[Python/dict| القواميس]] و[[Python/list | القوائم]] و[[Python/str | السلاسل النصية]] و[[Python/set | المجموعات]].

== القيمة المعادة ==
تعيد الدالة <code>join()</code>‎ [[Python/str|السلسلة النصية]] الناتجة عن ربط السلاسل النصية التابعة لكائن قابل للتكرار (iterable). إذا لم يكن أحد عناصر الكائن القابل للتكرار [[Python/str|سلسلة نصية]] تطلق الدالة الخطأ <code>TypeError</code>.

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

<syntaxhighlight lang="python3">
>>> 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

</syntaxhighlight>

== انظر أيضًا ==
* [[Python/str|السلاسل النصية في بايثون.]]

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