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

تجلب الدالة lastIndexOf()‎ فهرس آخر ظهور لمحرف أو سلسلة نصية محدَّدة من سلسلة المحارف التي استُدعيت معها.

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

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 إن لم يُعثَر على شيء.

أمثلة

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

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

    print(str.lastIndexOf('a')) // 8
    print(str.lastIndexOf('x')) // -1
}

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

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

    print(str.lastIndexOf("cad")) // 9
    print(str.lastIndexOf("dss")) // -1
}

انظر أيضًا

• الدالة last()‎: تجلب آخر محرف من محارف السلسلة التي استُدعيت معها إن لم يمرر إليها أي شيء، أو آخر محرف يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.
• الدالة lastIndexOfAny()‎: تجلب فهرس آخر ظهور لأيٍّ منه المحارف أو السلاسل النصية المعطاة من سلسلة المحارف التي استُدعيت معها.
• الدالة lastOrNull()‎: تجلب آخر محرف من محارف السلسلة التي استُدعيت معها إن لم يُمرَّر إليها أي شيء، أو آخر عنصر يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.
• الدالة indexOf()‎: تجلب فهرس أول ظهور لمحرف أو سلسلة نصية محدَّدة من سلسلة المحارف التي استُدعيت معها.
• الدالة find()‎: تبحث على محرف يحقق شرطًا محدَّدًا ضمن محارف السلسلة التي استُدعيت معها ثمَّ تعيد أول ظهور له.  

مصادر

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