الدالة CharSequence.indexOf()‎ في Kotlin

تجلب الدالة 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

المعاملات

char

المحرف المراد البحث عنه ضمن سلسلة من المحارف.

startIndex

السلسلة النصية المراد البحث عنها ضمن سلسلة من المحارف.

ignoreCase

قيمة منطقية تحدد إن كان يراد إهمال حالة المحارف أثناء عملية البحث أم لا. القيمة الافتراضية هي: false (أي أخذ حالة المحارف بالحسبان).

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

يعاد عدد صحيح يمثل فهرس أول ظهور للمحرف char أو السلسلة النصية string في سلسلة المحارف المعطاة، أو القيمة ‎-1 إن لم يُعثَر على شيء.

أمثلة

مثالٌ على استعمال الدالة ()indexOf للبحث عن محارف:

fun main(args: Array<String>) {
    var str = "hsoub"

    print(str.indexOf('s')) // 1
    print(str.indexOf('x')) // -1
}

مثالٌ آخر على استعمال الدالة ()indexOf للبحث عن سلسلة نصية:

fun main(args: Array<String>) {
    var str = "hsoub"

    print(str.indexOf("sou", 2, true)) // -1
    print(str.indexOf("sx", 1)) // -1
}

انظر أيضًا

• الدالة indexOfAny()‎: تجلب فهرس أول ظهور لأيٍّ منه المحارف أو السلاسل النصية المعطاة من سلسلة المحارف التي استُدعيت معها.
• الدالة indexOfFirst()‎: تجلب فهرس أول محرف يحقِّق شرطًا معيَّنًا من سلسلة المحارف التي استُدعيت معها.
• الدالة lastIndexOf()‎: تجلب فهرس آخر ظهور لمحرف أو سلسلة نصية محدَّدة من سلسلة المحارف التي استُدعيت معها. 
• الدالة find()‎: تبحث على محرف يحقق شرطًا محدَّدًا ضمن محارف السلسلة التي استُدعيت معها ثمَّ تعيد أول ظهور له.  
• الدالة filter()‎: ترشِّح محارف سلسلة المحارف أو السلسلة النصية المعطاة بناءً على قيمة المحرف التي تحقِّق شرطًا معيَّنًا.

مصادر

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