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

تنشئ الدالة asSequence()‎ كائنًا من الصنف Iterable والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقة التكرارية for.

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

fun CharSequence.asIterable(): Iterable<Char>

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

كائن من الصنف Iterable.

أمثلة

استخدام الدالةasSequence()‎

تعرّف الشيفرة التالية سلسلة نصية باسم str، ثم تستدعي الدالةasSequence()‎ عبرها وتحيل القيمة المُعادة إلى المتغير iter، ، ثم نطبَع الناتج باستخدام الحلقة التكرارية for:

fun main(args: Array<String>) {
val str = "hsoub"
val iter = str.asIterable() // إنشاء عنصر تكراري
 
for (i in iter) 
    print("$i.") // h.s.o.u.b.
}

انظر أيضًا

• append()‎:تضم الوسائط المُمرّرة إلى الكائن الذي استُدعيت عبره، والذي ينبغي أن يكون من الصنف Appendable.
• all()‎: تعيد الدالة all()‎ القيمة true إن كانت كل الحروف تحقق الشرط المنطقي المُمرّر predicate. 

• String()‎: تحو المصفوفة الممررة إلى سلسلة نصية.

• isDefined()‎: تعيد القيمة true في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).

• الخاصية indices: تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) لسلسلة الحروف التي استُدعيت عبرها.

مصادر

• الدالة text.asSequence()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.