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

من موسوعة حسوب
لا ملخص تعديل
طلا ملخص تعديل
 
(2 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع DoubleArray.iterator()‎ في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>DoubleArray.iterator()‎</code> في Kotlin}}</noinclude>
 
تنشئ الدالة <code>iterator()‎</code> عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه.
يعيد التابع <code>iterator()‎</code> عنصرًا تكراريًّا (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة.


== البنية العامة ==
== البنية العامة ==
سطر 7: سطر 6:
operator fun iterator(): DoubleIterator
operator fun iterator(): DoubleIterator


</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>DoubleArray</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 f: (Int) -> Double = { x -> x/4.0 }
    val f: (Int) -> Double = { x -> x / 4.0 }
val array = DoubleArray(6, f)
    val array = DoubleArray(6, f)


val iter = array.iterator()
    val iter = array.iterator()


for(element in iter)
    for(element in iter)
    print("$element ") // 0.0 0.25 0.5 0.75 1.0 1.25  
        print("$element ") // 0.0 0.25 0.5 0.75 1.0 1.25  
}
}
</syntaxhighlight>
</syntaxhighlight>


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


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

المراجعة الحالية بتاريخ 08:27، 9 سبتمبر 2018

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

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

operator fun iterator(): DoubleIterator

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

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

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

أمثلة

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

fun main(args: Array<String>) {
    val f: (Int) -> Double = { x -> x / 4.0 }
    val array = DoubleArray(6, f)

    val iter = array.iterator()

    for(element in iter)
        print("$element ") // 0.0 0.25 0.5 0.75 1.0 1.25 
}

انظر أيضًا

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

مصادر