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

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

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

l.insert()

المعاملات

i

موقع العنصر في القائمة الأصلية والذي سيدرج التابع العنصر الجديد قبله. يدرج التعبير a.insert(0, x)‎ العنصر 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.sort()‎: فرز القائمة في مكانها وذلك بإجراء مقارنة بين عناصر القائمة بواسطة العامل ‎<‎ فقط.
• التابع list.append()‎: إضافة عنصر إلى نهاية القائمة.
• التابع list.extend()‎: إضافة مجموعة من العناصر إلى نهاية القائمة.
• التابع list.remove()‎: حذف أول عنصر في القائمة تساوي قيمته القيمة التي يحدّدها المستخدم.
• التابع list.pop()‎: حذف العنصر في الموقع المحدّد من قبل المستخدم.
• التابع list.clear()‎: حذف جميع عناصر القائمة.
• التابع list.index()‎: تحديد موقع العنصر ضمن القائمة.
• التابع list.count()‎: تحديد عدد مرات تكرار العنصر الذي يحدّده المستخدم في القائمة.
• التابع list.reverse()‎: قلب ترتيب عناصر القائمة في مكانها.
• التابع list.copy()‎: إنشاء نسخة سطحية من القائمة.

مصادر

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