التابع ByteArray.iterator()‎ في Kotlin

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

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

operator fun iterator(): ByteIterator

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

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

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

أمثلة

استعمال التابع iterator()‎ لتخصيص عنصر تكراري من أجل استخدامه في الحلقة for التكرارية التي تطبع جميع العناصر:

import java.util.Arrays

fun main(args: Array<String>) {
    val f: (Int) -> Byte = { x -> x.toByte() }
    val array = ByteArray(6, f)
    val iter = array.iterator()

    for (element in iter)
        print("$element ") // 0 0 0 0 0 0
}

انظر أيضًا

• الصنف ‎ByteArray.
• الدالة ByteArray()‎: تنشئ مصفوفة جديدة من النوع ByteArray (أي حجم كل عنصر منها بايتًا واحدًا) بحجم معين، إذ تحوي قيمًا محدَّدة أو القيم 0. 
• التابع ()get: يجلب عنصرًا ذي فهرس محدد من المصفوفة.
• التابع set()‎: يضبط قيمة عنصر ذي فهرس محدد موجود في المصفوفة المستدعاة معه.
• الخاصية size: تمثل عدد العناصر الموجودة في المصفوفة.

مصادر

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