list.index() العثور على أول موضع لعنصر
آخر تحديث: 2026-09-22
list.index() العثور على أول موضع لعنصر
list.index(x[, start[, end]]) يُرجع فهرس أول ظهور لـ x؛ إذا لم يُوجد يرفع ValueError.
| التصنيف | دوال القوائم |
|---|---|
| النوع | دوال الأنواع المدمجة |
| إصدار بايثون | all |
📝 الصياغة
list.index(x[, start[, end]])⚙️ المعاملات
| value مطلوب | The element to search for. |
|---|---|
| start اختياري | Start index for the search; default is from the beginning.（القيمة الافتراضية：None） |
| end اختياري | End index (exclusive); default is to the end.（القيمة الافتراضية：None） |
القيمة المُعادة：int, the index of the first occurrence of value.
يعدّل الكائن الأصلي：لا (يُعيد كائنًا جديدًا)
💥 الاستثناءات
ValueError— Raised when value is not in the list (or the given range).
▶ مثال
عدّل الكود واضغط تشغيل لرؤية النتيجة في لوحة المخرجات:
المخرجات：
1
err: 3 is not in list💡 حالات ذات صلة
المزيد من الحالات قادم قريباً — تابعونا.
❓ أسئلة شائعة
Qماذا يحدث عندما لا يكون العنصر في القائمة؟
Aيتم إثارة خطأ ValueError: x is not in list.
Qكيف أبحث بأمان عن موضع عنصر ما؟
Aافحص باستخدام in أولًا: if x in lst: i = lst.index(x)؛ أو التقط خطأ ValueError باستخدام try/except.
Qكيف تُستخدم معاملات start/end؟
Aإنها تحدد نطاق البحث (مغلق من اليسار، مفتوح من اليمين): [10, 20, 30, 20].index(20, 2) يبدأ البحث من الفهرس 2 ويُرجع 3.
Qكيف أجد آخر تواجد للعنصر؟
Aلا تمتلك القوائم دالة rindex()؛ يمكنك البحث بالترتيب العكسي: len(lst) - 1 - lst[::-1].index(x).
