tuple.index() البحث عن موضع عنصر
آخر تحديث: 2026-09-22
tuple.index() البحث عن موضع عنصر
tuple.index(x[, start[, end]]) يُرجع فهرس أول ظهور لـ x؛ وإذا لم يجده يرفع ValueError.
| التصنيف | دوال الصفوف |
|---|---|
| النوع | دوال الأنواع المدمجة |
| إصدار بايثون | all |
📝 الصياغة
tuple.index(x[, start[, end]])⚙️ المعاملات
| x مطلوب | The element to search for. |
|---|---|
| start اختياري | Start index (inclusive); optional.（القيمة الافتراضية：0） |
| end اختياري | End index (exclusive); None means to the end.（القيمة الافتراضية：None） |
القيمة المُعادة：int. The first index of x; raises ValueError if not found.
يعدّل الكائن الأصلي：لا (يُعيد كائنًا جديدًا)
💥 الاستثناءات
ValueError— Raised when x is not in the tuple.
▶ مثال
عدّل الكود واضغط تشغيل لرؤية النتيجة في لوحة المخرجات:
المخرجات：
1💡 حالات ذات صلة
المزيد من الحالات قادم قريباً — تابعونا.
❓ أسئلة شائعة
Qماذا يحدث عندما لا يكون العنصر في التوابل؟
Aيتم إطلاق `ValueError: tuple.index(x): x not in tuple`.
Qهل يتم دعم معاملي `start`/`end`؟
Aنعم: `t.index(x, start, end)` يحدد نطاق البحث (مغلق من اليسار، مفتوح من اليمين)؛ وإن لم يُعثر عليه، فسيظل يُطلق `ValueError`.
Qكيف أبحث بأمان؟
Aافحص باستخدام `in` أولًا: `if x in t: i = t.index(x)`; أو التقط `ValueError` باستخدام `try/except`.
