الدالة asSequence()‎ في Kotlin

تُنشِئ الدالة asSequence()‎ نسخةً (instance) من النوع sequence والتي تُغلّف المصفوفة الأصلية وتعيد عناصرها عندما تُستخدَم في حلقات التكرار (مثل حلقة for).

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

تختلف بحسب نوع المصفوفة التي تُستدعَى عبرها:

fun <T> Array<out T>.asSequence(): Sequence<T> 
fun ByteArray.asSequence(): Sequence<Byte> 
fun ShortArray.asSequence(): Sequence<Short> 
fun IntArray.asSequence(): Sequence<Int> 
fun LongArray.asSequence(): Sequence<Long> 
fun FloatArray.asSequence(): Sequence<Float> 
fun DoubleArray.asSequence(): Sequence<Double> 
fun BooleanArray.asSequence(): Sequence<Boolean> 
fun CharArray.asSequence(): Sequence<Char>

ويمكن استدعاء الدالة asSequence()‎عبر مجموعة (collection) وستعيد نسخةً من النوع sequence والتي تُغلّف المجموعة التي استُدعيت عبرها وتعيد عناصرها عندما تُستخدَم في حلقات التكرار (مثل for):

fun <T> Iterable<T>.asSequence(): Sequence<T>

كما ويمكن استدعاء الدالة asSequence()‎عبر عنصر map وستعيد نسخةً من النوع sequence والتي تُغلّف عنصر map الذي استُدعيت عبره وتعيد مداخله (entries) عندما تُستخدم في حلقات التكرار (مثل for):

fun <K, V> Map<out K, V>.asSequence(): Sequence<Entry<K, V>>

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

تُعاد نسخة من النوع sequence (انظر شرح الدالة أعلاه لمزيدٍ من التفاصيل).

أمثلة

استخدام الدالة ()asSequence مع المصفوفات

تعرِّف الشيفرة الآتية مصفوفة محارف باسم array مكونة من ثلاثة أحرف باستخدام الدالة ()arrayOf، ثم تنشئ نسخةً من النوع sequence باسم sequence باستخدام الدالة ()asSequence وتضم عناصر sequence لسلسلةٍ نصيةٍ (string) عبر الدالة joinToString()‎ ثم تطبع الناتج:

fun main(args: Array<String>) {
    val array = arrayOf('a', 'b', 'c')
    val sequence = array.asSequence()

    println(sequence.joinToString()) // a, b, c
}

استخدام الدالة ()asSequence مع القوائم (Lists)

تعرف الشيفرة الآتية قائمةً باسم collection مكونة من ثلاثة أحرف باستخدام الدالة ()listOf، ثم تنشِئ نسخةً من النوع sequence باسم sequence وذلك باستخدام الدالة ()asSequenceثم تضم عناصر sequence لسلسلةٍ نصيةٍ (string) عبر الدالة joinToString()‎ ثم تطبع الناتج:

fun main(args: Array<String>) {
    val collection = listOf('a', 'b', 'c')
    val sequence = collection.asSequence()

    println(sequence.joinToString()) // a, b, c
}

انظر أيضًا

• الدالة asList()‎: تعيد قائمةً تُغلّف (wrap) المصفوفة الأصلية التي استُدعيت عبرها.

• الدالة asIterable()‎: تُعيد نسخةً تكراريّةً (iterable instance) تُغلّف (wrap) المصفوفة الأصلية وتعيد عناصرَها عندما تُستخدَم في حلقات التكرار (مثل for).

مصادر

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