الفرق بين المراجعتين لصفحة: «Python/array/extend»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>array.extend()</code> في بايثون}}</noinclude> يلحق التابع عناصر كائن التكرار المع...' |
لا ملخص تعديل |
||
سطر 12: | سطر 12: | ||
===<code>iterable</code>=== | ===<code>iterable</code>=== | ||
كائن التكرار المراد إضافة عناصره إلى نهاية المصفوفة. إن كان كائن التكرار المعطى هو مصفوفة أخرى، فيجب حينئذ أن تحمل رمز النوع نفسه، وإلا تطلق اللغة الخطأ TypeError. أما إن لم يكن كائن التكرار المعطى مصفوفةً، فيجب أن يكون كائن تكرار يتضمن عناصر يمكن إضافتها إلى المصفوفة. | كائن التكرار المراد إضافة عناصره إلى نهاية المصفوفة. إن كان كائن التكرار المعطى هو مصفوفة أخرى، فيجب حينئذ أن تحمل رمز النوع نفسه، وإلا تطلق اللغة الخطأ <code>TypeError</code>. أما إن لم يكن كائن التكرار المعطى مصفوفةً، فيجب أن يكون كائن تكرار يتضمن عناصر يمكن إضافتها إلى المصفوفة. | ||
== القيمة المعادة == | == القيمة المعادة == |
المراجعة الحالية بتاريخ 09:53، 23 أغسطس 2018
يلحق التابع عناصر كائن التكرار المعطى إلى نهاية المصفوفة.
البنية العامة
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 في توثيق بايثون الرسمي.