الدالة text.indexOfFirst()‎ في لغة Kotlin

تعيد الدالة indexOfFirst()‎ فهرس أول ظهور للحرف أو السلسلة النصية المُمرّرة إليها في سلسلة الحروف التي استُدعيت عبرها بداية من الفهرس المُمرّر startIndex، في حال كان ذلك الحرف غير موجود فستعيد العدد ‎-1.

في حال إعطاء الوسيط ignoreCase القيمة true فإنّ الدالة indexOf()‎ لن تفرق بين الحروف الكبيرة والصغيرة.

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

يمكن استدعاء الدالة indexOf()‎ عبر المصفوفات:

fun CharSequence.indexOf(
    char: Char, 
    startIndex: Int = 0, 
    ignoreCase: Boolean = false
): Int

fun CharSequence.indexOf(
    string: String, 
    startIndex: Int = 0, 
    ignoreCase: Boolean = false
): Int

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

فهرس أول ظهور للعنصر المُمرّر أو العدد ‎-1.

أمثلة

استخدام الدالة()indexOfFirstمع سلسلة نصية مع تمرير حرف كوسيط

تعرف الشيفرة الآتية سلسلة نصية باسم str، ثم تستخدم الدالة  ()indexOfFirst  للحصول على فهرس أول ظهور للحرفين 'x' و's' ، ثم تطبع الناتج:

fun main(args: Array<String>) {
var str = "hsoub"
    
print(str.indexOf('s')) // 1
print(str.indexOf('x')) // -1

}

استخدام الدالة()indexOfFirstمع سلسلة نصية مع تمرير سلسلة نصية كوسيط

تعرف الشيفرة الآتية سلسلة نصية باسم str، ثم تستخدم الدالة  ()indexOfFirst  للحصول على فهرس أول ظهور للسلسلتين النصيتين"sou" و"sx" ، ثم تطبع الناتج:

fun main(args: Array<String>) {
var str = "hsoub"
    
print(str.indexOf("sou")) // 1
print(str.indexOf("sx")) // -1
}

انظر أيضًا

• indexOfAny()‎: تعيد فهرس أول ظهور للحرف أو السلسلة النصية المُمرّرة إليها في سلسلة الحروف التي استُدعيت عبرها بداية من الفهرس المُمرّر startIndex، في حال كان ذلك الحرف أو تلك السلسلة النصية المُمرّرة غير موجودة فستعيد الدالةُ العدد ‎-1.

مصادر

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