الدالة associate() في لغة Kotlin
تعيد الدالة associate() قاموسًا (map) يحتوي أزواجًا "مفتاح-قيمة" ناتجة عن تمرير عناصر المصفوفة أو المجموعة (Collection) إلى الدالة transform.
إن كان لزوجين نفس المفتاح (key) فالأخير هو الذي سيُضاف إلى القاموس.
القاموس المُعاد يحافظ على نفس ترتيب التكرار الخاص بالمصفوفة أو المجموعة الأصلية.
البنية العامة
تعيد الدالة associate() قاموسًا (map) يحتوي أزواجًا "مفتاح-قيمة" ناتجة عن تمرير عناصر المصفوفة إلى الدالة transform.
inline fun <T, K, V> Array<out T>.associate(
transform: (T) -> Pair<K, V>
): Map<K, V>
inline fun <K, V> ByteArray.associate(
transform: (Byte) -> Pair<K, V>
): Map<K, V>
inline fun <K, V> ShortArray.associate(
transform: (Short) -> Pair<K, V>
): Map<K, V>
inline fun <K, V> IntArray.associate(
transform: (Int) -> Pair<K, V>
): Map<K, V>
inline fun <K, V> LongArray.associate(
transform: (Long) -> Pair<K, V>
): Map<K, V>
inline fun <K, V> FloatArray.associate(
transform: (Float) -> Pair<K, V>
): Map<K, V>
inline fun <K, V> DoubleArray.associate(
transform: (Double) -> Pair<K, V>
): Map<K, V>
inline fun <K, V> BooleanArray.associate(
transform: (Boolean) -> Pair<K, V>
): Map<K, V>
inline fun <K, V> CharArray.associate(
transform: (Char) -> Pair<K, V>
): Map<K, V>
تعيد الدالة associate() قاموسًا (map) يحتوي أزواجًا "مفتاح-قيمة" ناتجة عن تمرير عناصر المجموعة (Collection) إلى الدالة transform.
inline fun <T, K, V> Iterable<T>.associate(
transform: (T) -> Pair<K, V>
): Map<K, V>
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).
القيم المعادة
قاموس. (انظر شرح الدالة أعلاه لمزيد من التفاصيل)
أمثلة
استخدام الدالة ()associate مع اللوائح
تعرف الشيفرة الآتية لائحة باسم list مكونة من ثلاثة أحرف باستخدام الدالة ()listOf، ثم تنشئ قاموسًا باسم map بتمرير الدالة ()toMap (التي تحول الحروف إلى زوج مكون من الحرف في الحالة UpperCase ومن ترتيب الحرف) إلى()associate ثم تطبع الناتج:
fun main(args: Array<String>) {
val list = listOf('a','b','c')
val toMap: (Char) -> Pair<Char,Int> = {Pair(it.toUpperCase(),it.toInt())}
val map = list.associate(toMap)
println(map) // {A=97, B=98, C=99}
}
انظر أيضًا
associateBy(): تعيد قاموسًا (map).asList(): تعيد لائحة والتي تُغلّف المصفوفة الاصلية.
asIterable(): تُنشئ نسخة تكرارية (Iterable instance) والتي تُغلّف المصفوفة الاصلية وتعيد عناصرها عندما تُستخدم في حلقات التكرار (مثلfor).