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

المراجعة الحالية بتاريخ 07:12، 4 سبتمبر 2018

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

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

operator fun CharSequence.iterator(): CharIterator

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

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

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

أمثلة

مثالٌ على استعمال الدالة iterator()‎:

fun main(args: Array<String>) {    
    val str = "Hsoub" 
    val iter = str.iterator()

    for(element in iter)
       print("$element ") // H s o u b  
}

انظر أيضًا

الدالة asIterable()‎: تنشئ نسخةً من الواجهة Iterable التي تغلّف سلسلة المحارف التي استُدعيت معها لاستعمالها في الحلقات التكرارية، إذ تعيد محارفها عندما تُستخدَم في حلقات التكرار (مثل for).
الدالة asSequence()‎: تُنشِئ نسخةً من الواجهة Sequence التي تغلّف سلسلة المحارف التي استُدعيت معها لأجل استعمالها في الحلقات التكرارية، إذ تعيد كل محرف من محارفها عندما تُستخدَم في حلقات التكرار (مثل حلقة for).

مصادر

صفحة الدالة CharSequence.iterator في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة text.iterator()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.iterator()‎</code> في Kotlin}}</noinclude>
+تنشئ الدالة <code>iterator()‎</code> عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة محارف [[Kotlin/CharSequence|السلسلة]] المستدعاة معه.
-يعيد التابع <code>iterator()‎</code> عنصرًا تكراريًّا (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة.
 == البنية العامة ==
 <syntaxhighlight lang="kotlin">
-operator fun iterator(): FloatIterator
+operator fun CharSequence.iterator(): CharIterator
-</syntaxhighlight>ويُلاحظ وجود الكلمة المفتاحية <code>operator</code> للدلالة على أنّ هذا التابع مرتبطٌ بمعامل التكرار (iteration operator).
+</syntaxhighlight>وجود الكلمة المفتاحية <code>operator</code> يدل على أنّ هذه الدالة مرتبطٌة بمعامل التكرار (iteration operator، اطلع على المثال في الأسفل).
 == القيم المعادة ==
-عنصرٌ تكراريٌّ (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة.
+يعاد عنصرٌ تكراريٌّ (iterator) من أجل تكرار بنيةٍ (block) برمجيةٍ معينة على كافّة عناصر المصفوفة المعطاة.
 == أمثلة ==
+مثالٌ<nowiki/> على استعمال الدالة <code>iterator()‎</code>:<syntaxhighlight lang="kotlin">
+fun main(args: Array<String>) {
+    val str = "Hsoub"
+    val iter = str.iterator()
-=== استخدام التابع <code>iterator()‎</code> على مصفوفة ===
+    for(element in iter)
-تنشِئ الشيفرة الآتية مصفوفةً من ستة أعدادٍ بالاعتماد على الدالة <code>FloatArray</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">
+       print("$element ") // H s o u b
-fun main(args: Array<String>) {
+}
-val f: (Int) -> Float = { x -> x*4f }
-val array = FloatArray(6, f)
-val iter = array.iterator()
-for(element in iter)
-    print("$element ") // 0.0 4.0 8.0 12.0 16.0 20.0
-}
 </syntaxhighlight>
 == انظر أيضًا ==
-* الخاصيّة <code>[[Kotlin/FloatArray/size|FloatArray.size]]</code>: تعبِّر عن عدد العناصر الموجودة في المصفوفة.
+* الدالة <code>[[Kotlin/kotlin.text/asIterable|asIterable()‎]]</code>: تنشئ نسخةً من الواجهة <code>Iterable</code> التي تغلّف <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها لاستعمالها في الحلقات التكرارية، إذ تعيد محارفها عندما تُستخدَم في حلقات التكرار (مثل <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code>).
-* التابع <code>[[Kotlin/FloatArray/get|()get]]</code>: يعيد العنصر من المصفوفة المُحدَّدة عند الفهرس (index) المُعطى.
+* الدالة <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]‎</code>: تُنشِئ نسخةً من الواجهة <code>Sequence</code> التي تغلّف <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها لأجل استعمالها في الحلقات التكرارية، إذ تعيد كل محرف من محارفها عندما تُستخدَم في حلقات التكرار (مثل حلقة <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code>).
-* التابع <code>[[Kotlin/FloatArray/set|()set]]</code>: يعيّن‎ قيمة العنصر من المصفوفة المُحدَّدة عند الفهرس (index) المُعطى.
 == مصادر ==
-* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-float-array/iterator.html التابع text.iterator في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/iterator.html صفحة الدالة CharSequence.iterator في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin CharSequence]]