الفرق بين المراجعتين ل"Kotlin/Array/iterator"

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

المراجعة الحالية بتاريخ 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) المُعطى.

مصادر