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

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

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

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

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

المعاملات

predicate

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

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

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

أمثلة

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

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

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

انظر أيضًا

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

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

مصادر

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