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

مراجعة 09:26، 10 يوليو 2018

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

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

operator fun CharSequence.iterator(): CharIterator

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

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

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

أمثلة

استخدام الدالة`iterator()‎` على سلسلة نصية

تنشِئ الشيفرة الآتية سلسلة نصية باسم str، ثم تخصِّص لهذه السلسلة النصيةعنصرًا تكراريًا (iterator) باستخدام الدالةiterator()‎ لاستخدامه في حلقة for:

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

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

انظر أيضًا

isEmpty()‎: تعيد الدالة isEmpty()‎ القيمة true في حال كانت سلسلة الحروف التي استٌدعيت عبرها فارغة.

مصادر

التابع text.iterator في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة text.iterator()‎ في لغة Kotlin}}</noinclude>
-يعيد التابع <code>iterator()‎</code> عنصرًا تكراريًّا (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة.
+يعيد التابع <code>iterator()‎</code> عنصرًا تكراريًّا (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها.
 == البنية العامة ==
 <syntaxhighlight lang="kotlin">
-operator fun iterator(): FloatIterator
+operator fun CharSequence.iterator(): CharIterator
 </syntaxhighlight>ويُلاحظ وجود الكلمة المفتاحية <code>operator</code> للدلالة على أنّ هذا التابع مرتبطٌ بمعامل التكرار (iteration operator).
 == القيم المعادة ==
-عنصرٌ تكراريٌّ (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة.
+عنصرٌ تكراريٌّ (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]].
 == أمثلة ==
-=== استخدام التابع <code>iterator()‎</code> على مصفوفة ===
+=== استخدام الدالة<code>iterator()‎</code> على سلسلة نصية ===
-تنشِئ الشيفرة الآتية مصفوفةً من ستة أعدادٍ بالاعتماد على الدالة <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">
+تنشِئ الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str،</code> ثم تخصِّص لهذه [[Kotlin/String|السلسلة النصية]]<nowiki/>عنصرًا تكراريًا (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>) {
-val f: (Int) -> Float = { x -> x*4f }
+    val str = "Hsoub"
-val array = FloatArray(6, f)
+    val iter = str.iterator()
-val iter = array.iterator()
+    for(element in iter)
+       print("$element ") // H s o u b
+}
-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/isEmpty|isEmpty()]]‎</code>: تعيد الدالة <code>isEmpty()</code>‎ القيمة <code>true</code> في حال كانت [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها فارغة.
-* التابع <code>[[Kotlin/FloatArray/get|()get]]</code>: يعيد العنصر من المصفوفة المُحدَّدة عند الفهرس (index) المُعطى.
-* التابع <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 التابع text.iterator في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Method]]