الدالة text.iterator()‎ في لغة Kotlin

يعيد التابع 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.