التابع array.extend()‎ في بايثون

يلحق التابع عناصر كائن التكرار المعطى إلى نهاية المصفوفة.

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

‎array.extend(iterable)

المعاملات

iterable

كائن التكرار المراد إضافة عناصره إلى نهاية المصفوفة. إن كان كائن التكرار المعطى هو مصفوفة أخرى، فيجب حينئذ أن تحمل رمز النوع نفسه، وإلا تطلق اللغة الخطأ TypeError. أما إن لم يكن كائن التكرار المعطى مصفوفةً، فيجب أن يكون كائن تكرار يتضمن عناصر يمكن إضافتها إلى المصفوفة.

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

يعيد التابع القيمة None.

أمثلة

يبين المثال التالي آلية عمل التابع:

>>> import array
>>> ls = [6, 7, 8, 9]
>>> a1 = array.array('l', [1, 2, 3, 4, 5])
>>> a1.extend(ls)
>>> a1
array('l', [1, 2, 3, 4, 5, 6, 7, 8, 9])

انظر أيضًا

• التابع array.append()‎: يضيف التابع عنصرًا جديدًا يحمل القيمة المعطاة إلى نهاية المصفوفة.
• التابع array.insert()‎: يدرج التابع عنصرًا جديدًا يحمل القيمة المعطاة في المصفوفة قبل الموقع المحدد.
• التابع array.pop()‎: يحذف التابع العنصر في الموقع المحدد من المصفوفة ويعيده.
• التابع array.remove()‎: يحذف التابع أول ظهور للقيمة المعطاة من المصفوفة.

مصادر

صفحة Efficient arrays of numeric values في توثيق بايثون الرسمي.