عرض مصدر Kotlin/Array/iterator

<noinclude>{{DISPLAYTITLE: الدالة <code>‎‎Array.iterator()‎</code> في Kotlin}}</noinclude>
تعيد الدالة <code>Array.iterator()‎</code> عنصرًا تكراريًّا (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة.

== البنية العامة ==
<syntaxhighlight lang="kotlin">
operator fun iterator(): Iterator<T>
</syntaxhighlight>ويُلاحظ وجود الكلمة المفتاحية <code>operator</code> للدلالة على أنّ هذه الدالة مرتبطٌ بمعامل التكرار (iteration operator) المستخدم في شيفرة المثال اللاحق.

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

== أمثلة ==
تنشِئ الشيفرة الآتية مصفوفةً من ستة أعدادٍ صحيحةٍ بالاعتماد على الدالة <code>arrayOf</code> ثم تخصِّص لهذه المصفوفة عنصرًا تكراريًا (iterator) باستخدام الدالة <code>iterator()‎</code> لاستخدامه في حلقة <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code> المستخدمة لطباعة جميع عناصر المصفوفة:<syntaxhighlight lang="kotlin">
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
}
</syntaxhighlight>

== انظر أيضًا ==
* الخاصيّة <code>[[Kotlin/Array/size|Array.size]]</code>: تعبِّر عن عدد العناصر الموجودة في المصفوفة.
* الدالة <code>[[Kotlin/Array/get|()get]]</code>: تعيد العنصر من المصفوفة المُحدَّدة عند الفهرس (index) المُعطى.
* الدالة <code>[[Kotlin/Array/set|()set]]</code>: تعيّن‎ قيمة العنصر من المصفوفة المُحدَّدة عند الفهرس (index) المُعطى.

== مصادر ==
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-array/iterator.html صفحة الدالة ()Array.iterator في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Array]]