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

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

لتجنّب الالتباس عندما تحتوي السلاسل النصية الموجودة في الوسيط المُمرّر strings حروفا مشتركة، فإنّ الدالة findAnyOf()‎ تبدأ من نهاية تلك السلسلة النصية نحو بدايتها، وتبحث عند كل موضع عن العنصر الأول في stringsوالذي يطابق تلك السلسلة النصية عند ذلك الموضع.

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

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

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

زوجا مكونًا من فهرس آخر ظهور لأي واحدة من السلاسل النصية الموجودة فيstrings و السلسلة النصية المُطابقَة، أو تعيد  null إن لم يوجد أي تطابق.

أمثلة

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

تعرِّف الشيفرة الآتية سلسلة نصية باسم str، كما تعرّف لائحة من السلاسل النصية باسم strings، ثمَّ تستدعي الدالة()findLastAnyOf عبر str مع تمرير strings كوسيط، ثمَّ تطبع الناتج:

fun main(args: Array<String>) {
val str = "hsoub wiki" 
val strings = listOf("kotlin", "wiki","ki", "sou", "xyz")
    
println(str.findLastAnyOf(strings)) //  (8, ki)
}

انظر أيضًا

• find()‎: تعيد أول حرف من سلسلة الحروف التي استُدعيت عبرها يحقق الشرط المنطقي predicate.

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

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

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

مصادر

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