التابع text.indexOfAny()‎ في لغة Kotlin

تعيد الدالة indexOfAny()‎ فهرس أول ظهور لأيّ من الحروف أو السلاسل النصية الواردة في الوسيط المُمرّر (chars أو strings)، 

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

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

fun CharSequence.indexOfAny(
    chars: CharArray, 
    startIndex: Int = lastIndex, 
    ignoreCase: Boolean = false
): Int

fun CharSequence.indexOfAny(
    strings: Collection<String>, 
    startIndex: Int = lastIndex, 
    ignoreCase: Boolean = false
): Int

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

عدد.

أمثلة

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

تعرف الشيفرة الآتية سلسلة نصية باسم 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
}

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

تعرف الشيفرة الآتية سلسلة نصية باسم 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.indexOfAny()‎ في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.