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

تنشئ الدالة iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة محارف السلسلة المستدعاة معه.

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

operator fun CharSequence.iterator(): CharIterator

وجود الكلمة المفتاحية operator يدل على أنّ هذه الدالة مرتبطٌة بمعامل التكرار (iteration operator، اطلع على المثال في الأسفل).

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

يعاد عنصرٌ تكراريٌّ (iterator) من أجل تكرار بنيةٍ (block) برمجيةٍ معينة على كافّة عناصر المصفوفة المعطاة.

أمثلة

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

fun main(args: Array<String>) {    
    val str = "Hsoub" 
    val iter = str.iterator()

    for(element in iter)
       print("$element ") // H s o u b  
}

انظر أيضًا

• الدالة asIterable()‎: تنشئ نسخةً من الواجهة Iterable التي تغلّف سلسلة المحارف التي استُدعيت معها لاستعمالها في الحلقات التكرارية، إذ تعيد محارفها عندما تُستخدَم في حلقات التكرار (مثل for).
• الدالة asSequence()‎: تُنشِئ نسخةً من الواجهة Sequence التي تغلّف سلسلة المحارف التي استُدعيت معها لأجل استعمالها في الحلقات التكرارية، إذ تعيد كل محرف من محارفها عندما تُستخدَم في حلقات التكرار (مثل حلقة for).

مصادر

• صفحة الدالة CharSequence.iterator في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.