الدالة list.insert()‎ في بايثون

تضيف الدالة عنصرًا إلى القائمة في الموقع الذي يحدّده المستخدم.

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

l.insert()

المعاملات

i

موقع العنصر في القائمة الأصلية والذي ستدرج الدالة قبله العنصر الجديد. يدرج التعبير a.insert(0, x)‎ العنصر ء في بداية القائمة، أما التعبير a.insert(len(a), x)‎ فيدرج العنصر الجديد في نهاية القائمة وبهذا يصبح عمل الدالة في هذه الحالة مكافئًا لعمل الدالة a.append(x)‎.

x

العنصر المراد إضافته إلى القائمة.

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

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

أمثلة

يبين المثال التالي كيفية استخدام الدالة لإضافة عناصر إلى القائمة:

>>> fruits = ['orange', 'apple', 'pear', 'banana', 'kiwi', 'apple', 'banana']
>>> fruits.insert(0, 'grapes') # إضافة عنصر في بداية القائمة
>>> fruits
['grapes', 'orange', 'apple', 'pear', 'banana', 'kiwi', 'apple', 'banana']
>>> fruits.insert(4, 'watermelon') # إضافة عنصر قبل الموقع 4
>>> fruits
['grapes', 'orange', 'apple', 'pear', 'watermelon', 'banana', 'kiwi', 'apple', '
banana']
>>> fruits.insert(len(fruits), 'pineapple')   # إضافة عنصر إلى نهاية القائمة
>>> fruits
['grapes', 'orange', 'apple', 'pear', 'watermelon', 'banana', 'kiwi', 'apple', '
banana', 'pineapple']

انظر أيضًا

• الدالة list.append()‎ في بايثون
• الدالة list.extend()‎ في بايثون
• القوائم في بايثون.

مصادر

• قسم More on lists في صفحة Data Structures في توثيق بايثون الرسمي.