Kotlin/kotlin.text/indexOfAny

تعيد الدالة indexOf()‎ فهرس أول ظهور للحرف أو السلسلة النصية المُمرّرة إليها في سلسلة الحروف التي استُدعيت عبرها بداية من الفهرس المُمرّر 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

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

عدد.

أمثلة

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

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

fun main(args: Array<String>) {
var str = "hsoub"
var chars = charArrayOf('x', 'r', 'b')
    
print(str.indexOfAny(chars)) // 1
}

استخدام الدالة()indexOfمع سلسلة نصية: الحالة الثانية

تعرف الشيفرة الآتية سلسلة نصية باسم str، ثم تعرّف مصفوفة من النوع CharArray باسم chars، ثم تستدعي الدالة  ()indexOf عبر str للحصول على فهرس أول ظهور لأي حرف من الحروف الموجودة فيCharArray ، ولما كانت كل حروف CharArray غير موجودة في str فستعيد العدد ‎-1:

fun main(args: Array<String>) {
var str = "hsoub"
var chars = charArrayOf('x', 'r', 'w')
    
print(str.indexOfAny(chars)) // -1
}

انظر أيضًا

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

مصادر

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