الفرق بين المراجعتين لصفحة: «Kotlin/Array/iterator»

المراجعة الحالية بتاريخ 05:58، 8 سبتمبر 2018

تعيد الدالة 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.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع Array.iterator()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>‎‎Array.iterator()‎</code> في Kotlin}}</noinclude>
+تعيد الدالة <code>Array.iterator()‎</code> عنصرًا تكراريًّا (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة.
-يعيد التابع Array.iterator()‎ مُكرّرًا (iterator) لأجل تكرار بنية (block) برمجية على عناصر المصفوفة.
 == البنية العامة ==
+<syntaxhighlight lang="kotlin">
 operator fun iterator(): Iterator<T>
+</syntaxhighlight>ويُلاحظ وجود الكلمة المفتاحية <code>operator</code> للدلالة على أنّ هذه الدالة مرتبطٌ بمعامل التكرار (iteration operator) المستخدم في شيفرة المثال اللاحق.
-ويُلاحظ وجود الكلمة المفتاحية operator للدلالة على أنّ هذا التابع مرتبط بمعامل الفهرسة المذكور سابقًا.
 == القيم المعادة ==
-مُكرّر (iterator) لأجل تكرار كتلة (block) برمجية على عناصر المصفوفة.
+يعاد عنصرٌ تكراريٌّ (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">
-=== استخدام التابع iterator()‎ على مصفوفة ===
-تنشئ الشيفرة الآتية مصفوفة من ستة عناصر ثم تستخرج منه مُكرّرا (iterator) باستخدام التابع iterator()‎ ثم تستخدم ذلك المكرر داخل البنية for لطباعة جميع عناصر المصفوفة:
 fun main(args: Array<String>) {
+    val array = arrayOf(6,6,8,9,3,0)
-val array = arrayOf(6,6,8,9,3,0)
+    val iter = array.iterator()
+    for(element in iter)
-val iter = array.iterator()
+        print("$element ") // 6 6 8 9 3 0
-for(element in iter)
- print("$element ")
-// 6 6 8 9 3 0
 }
+</syntaxhighlight>
 == انظر أيضًا ==
-* الخاصية Array.size: تعبِّر عن عدد العناصر الموجودة في المصفوفة.
+* الخاصيّة <code>[[Kotlin/Array/size|Array.size]]</code>: تعبِّر عن عدد العناصر الموجودة في المصفوفة.
-* التابع Array.get()‎: يعيد العنصر عند الفهرس (index) المُحدَّد من المصفوفة.
+* الدالة <code>[[Kotlin/Array/get|()get]]</code>: تعيد العنصر من المصفوفة المُحدَّدة عند الفهرس (index) المُعطى.
+* الدالة <code>[[Kotlin/Array/set|()set]]</code>: تعيّن‎ قيمة العنصر من المصفوفة المُحدَّدة عند الفهرس (index) المُعطى.
 == مصادر ==
-* التابع Array.iterator في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin
+* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-array/iterator.html صفحة الدالة ()Array.iterator في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Methods]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Array]]