تعريفها
تستخدم لمعرفة ما إذا كان النص الذي قام باستدعائها يبدأ بنص معين أم لا.
مكان الباراميتر sub
يمكن تمرير نص عادي, أو مصفوفة نصوص نوعها tuple
.
- إذا قمت بتمرير نص عادي مكان الباراميتر
sub
فإنها ترجعTrue
إن كانت أحرفه تتطابق مع الأحرف الموجودة في بداية النص الذي قام باستدعائها. غير ذلك ترجعFalse
. - إذا قمت بتمرير مصفوفة نصوص نوعها
tuple
مكان الباراميترsub
فإنها ترجعTrue
في حال وجود نص فيها أحرفه تتطابق مع النص الذي يبدأ به النص الذي قام باستدعائها. غير ذلك ترجعFalse
.
بناؤها
startswith(sub[, start[, end]])
باراميترات
sub
عبارة عن نص عادي أو مصفوفة نصوص نوعهاtuple
.start
باراميتر إختياري, يمكنك أن تمرر مكانه عدد صحيح يحدد رقم الخانة التي تريد أن تبدأ البحث من عندها.end
باراميتر إختياري, يمكنك أن تمرر مكانه عدد صحيح يحدد رقم الخانة التي تريد أن توقف البحث قبلها.
ملاحظة: start
و end
يمكنك تمرير قيم مكانهما فقط في حال قمت بتمرير نص عادي مكان الباراميتر sub
.
قيمة الإرجاع
في حال كان النص الذي قام باستدعائها يبدأ بنص الباراميتر sub
( أو نص أحد عناصره في حال كان عبارة عن مصفوفة ) ترجع True
.
في حال كان نص الباراميتر sub
يبدأ عند الخانة التي قمنا بتحديد مكان الباراميتر start
في النص الذي قام باستدعائها ترجع True
.
في حال تم تمرير نص فارغ مكان الباراميتر sub
ترجع True
.
غير ذلك ترجع False
.
المثال الأول
s = 'welcome to harmash.com'; # s هنا قمنا بتعريف متغير نصي إسمه print(s.startswith('welcome to')) # s موجود في بداية نص المتغير 'welcome to' لأن النص True سترجع startswith() هنا الدالة print(s.startswith('welc')) # s موجود في بداية نص المتغير 'welc' لأن النص True سترجع startswith() هنا الدالة print(s.startswith('harmash')) # s غير موجود في بداية نص المتغير 'harmash' لأن النص False سترجع startswith() هنا الدالة print(s.startswith('harmash', 11)) # s موجود في بداية الخانة رقم 11 في المتغير 'harmash' لأن النص True سترجع startswith() هنا الدالة print(s.startswith('')) # لأننا نختبر قيمة نص فارغ True سترجع startswith() هنا الدالة
سنحصل على النتيجة التالية عند التشغيل.
True
False
True
True
المثال الثاني
# s هنا قمنا بتعريف متغير نصي إسمه s = 'Python is a programming language.' # و تحتوي على 3 نصوص tuple هنا قمنا بتعريف مصفوفة قيم نصية نوعها arr = ('Java', 'Python', 'PHP') # True سيتم طباعة 'PHP' أو النص 'Python' أو النص 'Java' إذا كان يبدأ بالنص .s هنا قمنا باختبار قيمة المتغير print(s.startswith(arr))
سنحصل على النتيجة التالية عند التشغيل.