Kotlin/kotlin.text/indexOfFirst

تعيد الدالة indexOfFirst()‎ فهرس ظهور أول حرف في سلسلة الحروف التي استُدعيت عبرها والذي يحقق الشرط المنطقي predicate، وفي حال كان ذلك الحرف غير موجود فستعيد العدد ‎-1.

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

يمكن استدعاء الدالة indexOf()‎ عبر المصفوفات:

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

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

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

عدد من النوع Int.

أمثلة

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

تعرف الشيفرة الآتية سلسلة نصية باسم str، ثم تستخدم الدالة  ()indexOfFirst للحصول على فهرس أول حرف يحقق الدالة المُمررة، ثم تطبع الناتج:

fun main(args: Array<String>) {
var str = "hsoub"
    
print(str.indexOfFirst { it > 'm' }) // 1
print(str.indexOfFirst { it > 'x' }) // -1
}

انظر أيضًا

• indexOfAny()‎: تعيد فهرس أول ظهور للحرف أو السلسلة النصية المُمرّرة إليها في سلسلة الحروف التي استُدعيت عبرها بداية من الفهرس المُمرّر startIndex، في حال كان ذلك الحرف أو تلك السلسلة النصية المُمرّرة غير موجودة فستعيد الدالةُ العدد ‎-1.

• indexOf()‎: تعيد الدالة indexOf()‎ فهرس أول ظهور للحرف أو السلسلة النصية المُمرّرة إليها في سلسلة الحروف التي استُدعيت عبرها بداية من الفهرس المُمرّر startIndex، في حال كان ذلك الحرف غير موجود فستعيد العدد ‎-1.

مصادر

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