الدالة text.findLast()‎ في لغة Kotlin

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

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

inline fun CharSequence.findLast(
    predicate: (Char) -> Boolean
): Char?

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

المعاملات

predicate

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

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

يعاد آخر ظهور للمحرف المبحوث عنه ضمن محارف السلسلة المعطاة والذي يحقق الشرط predicate المعطى أيضًا، أو تعاد القيمة null إن لم يُعثر على أي عنصر يحقق ذلك الشرط.

أمثلة

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

fun main(args: Array<String>) {
    val str = "abcdef"

    println(str.findLast{ it < 'd' }) //  c
}

انظر أيضًا

• findAnyOf()‎:تبحث الدالة findAnyOf()‎ عن أول ظهور لأي واحدة من السلاسل النصية الموجودة في الوسيط المُمرّر strings في سلسلة الحروف التي استُدعيت عبرها بداية من الفهرس startIndex، وفي حال إعطاء القيمة true للوسيط ignoreCase فستتجاهل الدالة حالة الحروف.
• find()‎: تعيد أول حرف من سلسلة الحروف التي استُدعيت عبرها يحقق الشرط المنطقي predicate.

• filterIndexed()‎: تعيد الدالة filterIndexed()‎ كل الحروف من سلسلة الحروف التي استُدعيت عبرها والتي تحقق الشرط المنطقي. يمرَّر فهرس كل عنصر وقيمته إلى الدالة predicate()‎ ثم تعيد بدورها قيمة منطقيَّة. 

• elementAt()‎: تعيد الحرف الموجود في الفهرس المُحدّد في سلسلة الحروف التي استُدعيت عبرها، في حال كان الفهرس خارج الحدود فستطلق الاستثناء IndexOutOfBoundsException. 

مصادر

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