Kotlin/Array/iterator

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

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

operator fun iterator(): Iterator<T>

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

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

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

أمثلة

استخدام التابع iterator()‎ على مصفوفة

تنشِئ الشيفرة الآتية مصفوفةً من ستة أعدادٍ صحيحةٍ بالاعتماد على الدالة 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.