Kotlin/kotlin.text/indexOf

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

في حال إعطاء الوسيط ignoreCase القيمة true فإنّ الدالة 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.

أمثلة

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

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

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

}

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

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

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

انظر أيضًا

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

مصادر

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