الدالة CharSequence.associateTo()‎ في Kotlin

تشبه الدالة associateTo()‎ الدالة associate()‎ تمامًا باستثناء أنها تضيف الناتج الذي تعيده إلى خريطة موجودة مسبقًا. 

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

inline fun <K, V, M : MutableMap<in K, in V>> CharSequence.associateTo(
    destination: M, 
    transform: (Char) -> Pair<K, V>
): M

وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions)).

المعاملات

destination

خريطة متغيرة تمثل الوجهة التي ستوضع فيها الخرائط التي تعيدها الدالة associateTo()‎.

transform

دالةٌ يمرر إليها كل محرف من محارف سلسلة المحارف المعطاة وتعيد خريطة مكونة من أزواج من "مفتاح/قيمة".

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

يعاد المعامل destination نفسه بعد إضافة الخرائط المتشكلة إليه، إذ تنتج هذه الخرائط المضافة عن تمرير محارف سلسلة المحارف المعطاة إلى الدالة transform.

أمثلة

استعمال ()associateByTo لتخزين الخرائط المتشكلة في خريطة موجودةً مسبقًا:

fun main(args: Array<String>) {
    val str = "hsoub"
    val map = mutableMapOf<Char, Char>()

    val func: (Char) -> Pair<Char, Char> = {
        Pair(it.toUpperCase(), it.toLowerCase())
    }

    str.associateTo(map, func)
    println(map) // {H=h, S=s, O=o, U=u, B=b}
}

انظر أيضًا

• الدالة associate()‎: تعيد خريطة (map) تحوي أزواجًا من "مفتاح/قيمة" ناتجة عن تمرير محارف سلسلة المحارف التي استُدعيت معها إلى الدالة الممررة إليها. 
• الدالة associateBy()‎: تعيد خريطةً (map) مكونة من الأزواج "مفتاح/قيمة"، إذ يكون المفتاح (key) هو الناتج الذي تعيده الدالة keySelector الممررة إليها وتكون القيمة (value) المقابلة لذلك المفتاح هي إمَّا محارف سلسلة المحارف المعطاة أو الناتج الذي تعيده الدالة valueTransform الممررة. 

• الدالة associateByTo()‎: تشبه الدالة associateBy()‎ تمامًا باستثناء أنها تضيف الناتج الذي تعيده إلى خريطة موجودة مسبقًا. 
• الدالة asIterable()‎: تنشئ نسخةً من الواجهة Iterable التي تغلّف سلسلة المحارف التي استُدعيت معها لاستعمالها في الحلقات التكرارية، إذ تعيد محارفها عندما تُستخدَم في حلقات التكرار (مثل for).

مصادر

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