الدالة withIndex()‎ في Kotlin

تعيد الدالة withIndex()‎ مجموعة تكرارية خاملة (lazy Iterable) من القيم المُفهرسة لكل محرف من محارف السلسلة التي استُدعيت معها.

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

fun CharSequence.withIndex(): Iterable<IndexedValue<Char>>

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

تعاد مجموعة تكرارية خاملة (lazy Iterable) من القيم المُفهرسة لكل محرف من محارف السلسلة المعطاة.

أمثلة

مثالٌ على استعمال الدالة ()withIndex مع سلسلة نصية ثم إسناد الناتج الذي تعيده إلى المتغير iter، لاستخدامه في حلقة تكرارية for:

fun main(args: Array<String>) {
    val iter = "hsoub".withIndex()

    for (x in iter) println(x)
    // المخرجات
    //IndexedValue(index=0, value=h)
    //IndexedValue(index=1, value=s)
    //IndexedValue(index=2, value=o)
    //IndexedValue(index=3, value=u)
    //IndexedValue(index=4, value=b)
}

انظر أيضًا

• الدالة asIterable()‎: تنشئ نسخةً من الواجهة Iterable التي تغلّف سلسلة المحارف التي استُدعيت معها لاستعمالها في الحلقات التكرارية، إذ تعيد محارفها عندما تُستخدَم في حلقات التكرار (مثل for).
• الدالة iterator()‎: تنشئ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة محارف السلسلة المستدعاة معه.

مصادر

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