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

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

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

operator fun iterator(): Iterator<T>

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

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

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

أمثلة

تنشِئ الشيفرة الآتية مصفوفةً من ستة أعدادٍ صحيحةٍ بالاعتماد على الدالة arrayOf ثم تخصِّص لهذه المصفوفة عنصرًا تكراريًا (iterator) باستخدام الدالة iterator()‎ لاستخدامه في حلقة for المستخدمة لطباعة جميع عناصر المصفوفة:

fun main(args: Array<String>) {
    val array = arrayOf(6,6,8,9,3,0)
    val iter = array.iterator()
    for(element in iter)
        print("$element ") // 6 6 8 9 3 0
}

انظر أيضًا

• الخاصيّة Array.size: تعبِّر عن عدد العناصر الموجودة في المصفوفة.
• الدالة ()get: تعيد العنصر من المصفوفة المُحدَّدة عند الفهرس (index) المُعطى.
• الدالة ()set: تعيّن‎ قيمة العنصر من المصفوفة المُحدَّدة عند الفهرس (index) المُعطى.

مصادر

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