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

من موسوعة حسوب

تعيد الدالة find()‎ أدنى قيمة للفهرس في السلسلة النصية والذي تكون السلسلة الفرعية موجودة فيه ضمن الجزء المقتطع من السلسلة.

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

x.find()

المعاملات

sub

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

start

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

end

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

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

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

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

أمثلة

يوضّح المثال التالي النتائج المعادة من الدالة find()‎:

>>> string = "Python programming language"
>>> string.find("p")
7
>>> string.find("q")
-1
>>> string.find("mm", 7, 18)
13
>>> string.find("mm")
13
>>> string.find("mm", 0, 8)
-1

ملاحظة

يستخدم التابع find()‎ لمعرفة موقع السلسلة الفرعية فقط. وللتأكد من وجود السلسلة النصية ضمن السلسلة الأصلية يجب استخدام العامل in:

>>> 'Py' in 'Python'
True

انظر أيضًا

مصادر