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

مراجعة 06:06، 10 أغسطس 2018

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

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

operator fun iterator(): BooleanIterator

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

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

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

أمثلة

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

fun main(args: Array<String>) {    
    val array = BooleanArray(4) {it % 2 == 0}
    val iter = array.iterator()
    
    for(element in iter)
        print("$element ") // true false true false    
}

انظر أيضًا

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

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع BooleanArray.iterator()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>BooleanArray.iterator()‎</code> في Kotlin}}</noinclude>
+ينشئ التابع <code>iterator()‎</code> عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه.
-يعيد التابع <code>iterator()‎</code> عنصرًا تكراريًّا (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة.
 == البنية العامة ==
@@ سطر 7: / سطر 6: @@
 operator fun iterator(): BooleanIterator
-</syntaxhighlight>ويُلاحظ وجود الكلمة المفتاحية <code>operator</code> للدلالة على أنّ هذا التابع مرتبطٌ بمعامل التكرار (iteration operator) المستخدم في شيفرة المثال اللاحق.
+</syntaxhighlight>وجود الكلمة المفتاحية <code>operator</code> يدل على أنّ هذا التابع مرتبطٌ بمعامل التكرار (iteration operator، اطلع على المثال في الأسفل).
 == القيم المعادة ==
-عنصرٌ تكراريٌّ (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة.
+يعاد عنصرٌ تكراريٌّ (iterator) من أجل تكرار بنيةٍ (block) برمجيةٍ معينة على كافّة عناصر المصفوفة المعطاة.
 == أمثلة ==
+استعمال التابع <code>iterator()‎</code> لتخصيص عنصر تكراري من أجل استخدامه في الحلقة <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code> التكرارية التي تطبع جميع العناصر:<syntaxhighlight lang="kotlin">
-=== استخدام التابع <code>iterator()‎</code> على مصفوفة ===
-تنشِئ الشيفرة الآتية مصفوفةً من أربعة قيم منطقية بالاعتماد على الدالة <code>BooleanArray</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 = BooleanArray(4) {it % 2 == 0}
@@ سطر 26: / سطر 23: @@
 == انظر أيضًا ==
-* <code>[[Kotlin/BooleanArray/get|()get]]</code>: يعيد العنصر من المصفوفة المُحدَّدة عند الفهرس (index) المُعطى.
+* الصنف <code>‎‎[[Kotlin/BooleanArray|BooleanArray]]</code>[[Kotlin/BooleanArray|‎]].
-* الخاصية <code>[[Kotlin/BooleanArray/size|size]]</code>: تعبِّر الخاصيّة <code>size‎</code> عن عدد العناصر الموجودة في المصفوفة.
+* الدالة <code>[[Kotlin/BooleanArray/Init|BooleanArray()‎]]</code>: تنشئ [[Kotlin/Array|مصفوفة]] جديدة بحجم معين تحوي قيمًا منطقية محدَّدة أو القيمة <code>false</code> المنطقية.
+* التابع <code>[[Kotlin/BooleanArray/get|()get]]</code>: يجلب عنصرًا ذي فهرس محدد من المصفوفة.
+* التابع [[Kotlin/BooleanArray/set|<code>set()</code>‎]] : يضبط قيمة عنصر ذي فهرس محدد موجود في المصفوفة المستدعاة معه.
+* الخاصية <code>[[Kotlin/BooleanArray/size|size]]</code>: تمثل عدد العناصر الموجودة في المصفوفة.
 == مصادر ==
-* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean-array/iterator.html التابع BooleanArray.iterator في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean-array/iterator.html صفحة التابع ()BooleanArray.iterator في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Method]]