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

تجلب الدالة indexOfLast()‎ فهرس آخر محرف يحقِّق شرطًا معيَّنًا من سلسلة المحارف التي استُدعيت معها. 

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

inline fun CharSequence.indexOfLast(
    predicate: (Char) -> Boolean
): Int

وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق الدوال المباشرة (inline functions)).

المعاملات

predicate

دالةٌ تمثل الشرط الذي سيطبَّق على كل محرف من محارف السلسلة المعطاة، إذ يمرر إليها المحرف ثم تعيد قيمة منطقية مقابلة له.

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

يُعاد عدد صحيح يمثل فهرس آخر محرف حقَّق الشرط المنطقي predicate المعطى في سلسلة المحارف المعطاة، أو القيمة ‎-1 إن لم يتطابق أيُّ عنصرٍ مع ذلك الشرط..

أمثلة

مثالٌ على استعمال الدالة ()indexOfLast:

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

    print(str.indexOfLast { it > 'm' }) // 3
    print(str.indexOfLast { it > 'x' }) // -1
}

انظر أيضًا

• الدالة indexOf()‎: تجلب فهرس أول ظهور لمحرف أو سلسلة نصية محدَّدة من سلسلة المحارف التي استُدعيت معها. 
• الدالة indexOfAny()‎: تجلب فهرس أول ظهور لأيٍّ منه المحارف أو السلاسل النصية المعطاة من سلسلة المحارف التي استُدعيت معها.

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

مصادر

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