الفرق بين المراجعتين لصفحة: «Kotlin/Array/iterator»
لا ملخص تعديل |
مراجعة |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: التابع Array.iterator() في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: التابع Array.iterator() في لغة Kotlin}}</noinclude> | ||
يعيد التابع <code>Array.iterator()</code> | يعيد التابع <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>iterator()</code> على مصفوفة === | === استخدام التابع <code>iterator()</code> على مصفوفة === | ||
تنشِئ الشيفرة الآتية مصفوفةً من ستة أعدادٍ صحيحةٍ بالاعتماد على الدالة <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/get| | * التابع <code>[[Kotlin/Array/set|()set]]</code>: يعيّن قيمة العنصر من المصفوفة المُحدَّدة عند الفهرس (index) المُعطى. | ||
* التابع <code>[[Kotlin/Array/set|() | |||
== مصادر == | == مصادر == | ||
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-array/iterator.html التابع Array.iterator في التوثيق | * [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-array/iterator.html التابع Array.iterator في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin | [[تصنيف:Kotlin Method]] | ||
مراجعة 00:04، 30 مايو 2018
يعيد التابع Array.iterator() عنصرًا تكراريًّا (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة.
البنية العامة
operator fun iterator(): Iterator<T>
ويُلاحظ وجود الكلمة المفتاحية operator للدلالة على أنّ هذا التابع مرتبطٌ بمعامل التكرار (iteration operator) المستخدم في شيفرة المثال اللاحق.
القيم المعادة
عنصرٌ تكراريٌّ (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة.
أمثلة
استخدام التابع iterator() على مصفوفة
تنشِئ الشيفرة الآتية مصفوفةً من ستة أعدادٍ صحيحةٍ بالاعتماد على الدالة 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) المُعطى.