بايثونالدالة index()
تعريفها
تبحث في الـlist
الذي قام باستدعائها عن رقم فهرس أول عنصر يملك القيمة التي نمرره لها مكان الباراميتر x
و ترجعه.
بناؤها
index(x[, start[, end]])
باراميترات
- مكان الباراميتر
x
نمرر القيمة التي نريد البحث عنها. start
هو باراميتر إختياري، مكانه يمكننا تمرير رقم فهرس العنصر الذي نريد بدء البحث من عنده.end
هو باراميتر إختياري، مكانه يمكننا تمرير رقم فهرس العنصر الذي نريد إيقاف البحث قبله.
قيمة الإرجاع
ترجع رقم فهرس أول عنصر يملك القيمة التي نمررها لها مكان الباراميتر x
.
أخطاء محتملة
ترمي الإستثناء ValueError في حال لم يتم العثور على القيمة المراد معرفة مكانها.
مثال
# وضعنا فيه مجموعة أعداد صحيحة alist إسمه list هنا قمنا بتعريف alist = [1, 2, 3, 4, 5] # 3 أول عنصر يملك القيمة index هنا قمنا بعرض print(alist.index(3)) # alist هنا قمنا بعرض رقم فهرس أول عنصر يملك القيمة 3 و بدأنا عملية البحث من ثاني عنصر موجود في الكائن print(alist.index(3, 1)) # و حتى آخر عنصر موجود فيه alist هنا قمنا بعرض رقم فهرس أول عنصر يملك القيمة 3 و بدأنا عملية البحث من ثاني عنصر موجود في الكائن print(alist.index(3, 1, 5)) # عند التشغيل ValueError هنا قمنا بعرض رقم فهرس أول عنصر يملك القيمة 10 و بما أنه لا يوجد أي عنصر عنده هذه القيمة سيظهر الخطأ print(alist.index(10))
النتيجة
2
2
2
ValueError: 10 is not in list
2
2
ValueError: 10 is not in list