Javaالدالة startsWith()
في جافا
تعريفها
تستخدم لمعرفة ما إذا كان الـ String
الذي قام باستدعائها يبدأ بنص معين أم لا.
إذا كانت قيمة الباراميتر prefix
موجودة في بدايته ترجع true
, غير ذلك ترجع false
.
عند إستدعاء هذه الدالة عندنا خيارين:
- عدم تحديد من أين تبدأ, و في هذه الحالة ستبدأ من أول حرف في الـ
String
الذي قام باستدعائها. - تحديد من أين تبدأ.
بناؤها
هناك شكلين من هذه الدالة. أي يمكن إستدعاءها بطريقتين مختلفتين.
// الشكل الأول public boolean startsWith(String prefix) // الشكل الثاني public boolean startsWith(String prefix, int toffset)
باراميترات
- مكان البارميتر
prefix
نمرر الـ substring الذي نريد معرفة ما إذا كان موجوداً في بداية الـString
أم لا. - مكان البارميتر
toffset
نمرر الـ index الذي ستبدأ عملية الإختبار من عنده.
قيمة الإرجاع
ترجع true
إذا كانت القيمة التي مررناها مكان الباراميتر toffset
موجودة في بداية النص, أو في المكان الذي قمنا بتحديد بدأ عملية البحث عنده.
ترجع true
أيضاً في حال قمنا باختبار قيمة فارغة.
غير ذلك ترجع false
.
مثال
public class Main { public static void main(String[] args) { String str = "welcome to harmash.com"; System.out.println( str.startsWith("welcome to") ); // str لأنها موجودة في بداية النص true سترجع System.out.println( str.startsWith("welc") ); // str لأنها موجودة في بداية النص true سترجع System.out.println( str.startsWith("harmash") ); // str لأنها ليست موجودة في بداية النص false سترجع System.out.println( str.startsWith("harmash", 11) ); // str رقم 11 في النص index لأنها موجودة في بداية الـ true سترجع System.out.println( str.startsWith("") ); // لأننا نختبر قيمة فارغة true سترجع } }
سنحصل على النتيجة التالية عند التشغيل.
true true false true true