عرض مصدر Python/array/extend

<noinclude>{{DISPLAYTITLE:التابع <code>array.extend()‎</code> في بايثون}}</noinclude>

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

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

<syntaxhighlight lang="python3">
‎array.extend(iterable)
</syntaxhighlight>

== المعاملات ==
===<code>iterable</code>===

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

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

يعيد التابع القيمة <code>None</code>.

== أمثلة ==

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

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

</syntaxhighlight>

== انظر أيضًا ==
* [[Python/array/append|التابع <code>array.append()‎</code>]]: يضيف التابع عنصرًا جديدًا يحمل القيمة المعطاة إلى نهاية المصفوفة.
* [[Python/array/insert|التابع <code>array.insert()‎</code>]]: يدرج التابع عنصرًا جديدًا يحمل القيمة المعطاة في المصفوفة قبل الموقع المحدد.
* [[Python/array/pop|التابع <code>array.pop()‎</code>]]: يحذف التابع العنصر في الموقع المحدد من المصفوفة ويعيده.
* [[Python/array/remove|التابع <code>array.remove()‎</code>]]: يحذف التابع أول ظهور للقيمة المعطاة من المصفوفة.

== مصادر ==
[https://docs.python.org/3/library/array.html#array.extend صفحة Efficient arrays of numeric values في توثيق بايثون الرسمي.]

[[تصنيف:Python]]
[[تصنيف:Python Modules]]
[[تصنيف:Python Methods]]