Kotlin/kotlin.text/startsWith

تعيد الدالة startsWith()‎ القيمة true إن كانت سلسلة الحروف أو السلسلة النصية التي استُدعيت عبرها تبدأ بالحرف أو السابقة المُمرّرة. الوسيط ignoreCase يحدد ما إذا كانت الدالة ستتجاهل حالة الحروف.

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

fun String.startsWith(
    prefix: String, 
    ignoreCase: Boolean = false
): Boolean

fun CharSequence.startsWith(
    prefix: CharSequence, 
    ignoreCase: Boolean = false
): Boolean

تعيد الدالة startsWith()‎ القيمة true إن كانت السلسلة النصية أو سلسلة الحروف التي استُدعيت عبرها تبدأ بالبادئة prefix.

fun String.startsWith(
    prefix: String, 
    startIndex: Int, 
    ignoreCase: Boolean = false
): Boolean

fun CharSequence.startsWith(
    prefix: CharSequence, 
    startIndex: Int, 
    ignoreCase: Boolean = false
): Boolean

تعيد الدالة startsWith()‎ القيمة true إن كانت الجزء من السلسلة النصية أو سلسلة الحروف التي استُدعيت عبرها والذي يبدأ عند الفهرس المحدد startIndex يبدأ بالبادئة prefix.

fun CharSequence.startsWith(
    char: Char, 
    ignoreCase: Boolean = false
): Boolean

تعيد الدالة startsWith()‎ القيمة true إن كانت سلسلة الحروف التي استُدعيت عبرها تبدأ بالحرف char.

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

قيمة منطقية.

أمثلة

استخدام الدالة ()startsWith مع سلسلة نصية

تعرِّف الشيفرة الآتية سلسلة نصية باسم str، ثمَّ تستدعي الدالة ()startsWith عبرها مع تمرير سلسلة نصية كوسيط، ثمَّ تطبع الناتج:

fun main(args: Array<String>) {
val str = "wiki.hsoub.com"
    
println(str.startsWith("wiki")) // true
println(str.startsWith("xyz")) // false
}

انظر أيضًا

• endsWith()‎: تعيد الدالة endsWith()‎ القيمة true إن كانت سلسلة الحروف أو السلسلة النصية التي استُدعيت عبرها تنتهي بالحرف أو اللاحقة المُمرّرة. الوسيط ignoreCase يحدد ما إذا كانت الدالة ستتجاهل حالة الحروف. 
• elementAt()‎: تعيد الحرف الموجود في الفهرس المُحدّد في سلسلة الحروف التي استُدعيت عبرها، في حال كان الفهرس خارج الحدود فستطلق الاستثناء IndexOutOfBoundsException. 

• compareTo()‎: تقارن بين سلسلتين نصيتين.

مصادر

• الدالة text.startsWith()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.