الفرق بين المراجعتين لصفحة: «Kotlin/Array/iterator»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
| (3 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: | <noinclude>{{DISPLAYTITLE: الدالة <code>Array.iterator()</code> في Kotlin}}</noinclude> | ||
تعيد الدالة <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) برمجيةٍ على كافّة عناصر المصفوفة. | |||
== أمثلة == | == أمثلة == | ||
تنشِئ الشيفرة الآتية مصفوفةً من ستة أعدادٍ صحيحةٍ بالاعتماد على الدالة <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>) { | 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 | ||
} | } | ||
</syntaxhighlight> | </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 | * [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-array/iterator.html صفحة الدالة ()Array.iterator في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin | [[تصنيف: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) المُعطى.