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

تعيد الدالة associate()‎ قاموسًا (map) يحتوي أزواجًا من "مفتاح/قيمة" ناتجة عن تمرير عناصر سلسلة الحروف التي استُدعيت عبرها.

إن كان لزوجين نفس المفتاح (key) فالأخير هو الذي سيُضاف إلى القاموس.

يحافظ القاموسالمُعاد على نفس ترتيب التكرار الخاص بسلسلة الحروف الأصليَّة.

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

inline fun <K, V> CharSequence.associate(
    transform: (Char) -> Pair<K, V>
): Map<K, V>

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

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

قاموس.

أمثلة

استخدام الدالة ()associate

تعرِّف الشيفرة الآتية سلسلة نصية باسم str، ثمَّ تنشئ قاموسًاباسم map بتمرير الدالة ()toMap إلى ()associateالتي تحول تلك الحروف إلى زوج مكون من الحرف في الحالة الكبيرة [UpperCase] ومن قيمته العددية، ثمَّ تطبع الناتج:

fun main(args: Array<String>) {
val str = "hsoub"
val toMap: (Char) -> Pair<Char, Int> = {
        Pair(it.toUpperCase(), it.toInt())
    }
    val map = str.associate(toMap)

    println(map) // {H=104, S=115, O=111, U=117, B=98}
}

انظر أيضًا

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

• all()‎: تعيد الدالة all()‎ القيمة true إن كانت كل الحروف تحقق الشرط المنطقي المُمرّر predicate. 

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

مصادر

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