التابع bytes.join()‎ في بايثون

يعيد التابع join()‎ كائن البياتات أو كائن مصفوفة البايتات الناتج عن ربط البيانات الثنائية التابعة لكائن قابل للتكرار (iterable).

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

str.join(iterable)

المعاملات

iterable

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

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

يعيد التابع join()‎ كائن البياتات أو كائن مصفوفة البايتات الناتج عن ربط البيانات الثنائية التابعة لكائن قابل للتكرار (iterable).

يطلق التابع الخطأ TypeError إن تضمن المعامل iterable أي قيمة ليست شبيهة بالبايتات (bytes-like object)، إضافة إلى السلاسل النصية.

أمثلة

يبين المثال التالي القيم المعادة من تطبيق التابع:

>>> s = [b'100', b'200', b'300', b'400', b'500']
>>> sep = b', '
>>> sep.join(s)
b'100, 200, 300, 400, 500'
>>> s = [b'100', b'200', b'300', '400', b'500']
>>> sep = b', '
>>> sep.join(s)
Traceback (most recent call last):
  File "<input>", line 1, in <module>
    sep.join(s)
TypeError: sequence item 3: expected a bytes-like object, str found

انظر أيضًا

• البايتات في بايثون.

مصادر

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