الدالة str.index()‎ في بايثون

تؤدي هذه الدالة نفس وظيفة الدالة find()‎ ولكنّها تطلق الخطأ ValueError إن لم تعثر على السلسلة الفرعية.

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

x.find()

المعاملات

sub

السلسلة الفرعية المراد معرفة موقعها.

start

الموقع الذي تبدأ منه الدالة عملية البحث ضمن السلسلة الأصلية.

end

الموقع الذي تنهي فيه الدالة عملية البحث ضمن السلسلة الأصلية.

يسلك هذان المعاملان نفس السلوك المتّبع في عملية اقتطاع السلاسل النصية slicing.

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

تعيد الدالة أدنى قيمة للفهرس في السلسلة النصية حيث تكون السلسلة الفرعية sub موجودة في الجزء المقتطع من السلسلة s[start:end]‎، وتطلق الخطأ ValueError إن لم تعثر على السلسلة الفرعية.

أمثلة

>>> mycar = "I have a blue car"
>>> mycar.index("blue")
9
>>> mycar.index("red")
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ValueError: substring not found

انظر أيضًا

• السلاسل النصية في بايثون.
• الدالة find()‎ في بايثون.

مصادر

• قسم index في صفحة Types في توثيق بايثون الرسمي.