الدالة associateTo()
في لغة Kotlin
تعيد الدالة associateByTo()
قاموسًا متغيرا (mutable map) يحتوي ناتج تمرير عناصر المصفوفة أو المجموعة (Collection
) إلى الدالة transform
.
ان كان لعنصرين نفس المفتاح (key) بعد تطبيق الدالةkeySelector
فإن الأخير هو الذي سيُضاف إلى القاموس.
البنية العامة
في حال استدعاء الدالة associateByTo()
عبر مصفوفة فستعيد القاموس المتغير destination
أزواجه توفرها الدالة transform()
مُطبقةً على عناصر المصفوفة:
inline fun <T, K, V, M : MutableMap<in K, in V>> Array<out T>.associateTo(
destination: M,
transform: (T) -> Pair<K, V>
): M
inline fun <K, V, M : MutableMap<in K, in V>> ByteArray.associateTo(
destination: M,
transform: (Byte) -> Pair<K, V>
): M
inline fun <K, V, M : MutableMap<in K, in V>> ShortArray.associateTo(
destination: M,
transform: (Short) -> Pair<K, V>
): M
inline fun <K, V, M : MutableMap<in K, in V>> IntArray.associateTo(
destination: M,
transform: (Int) -> Pair<K, V>
): M
inline fun <K, V, M : MutableMap<in K, in V>> LongArray.associateTo(
destination: M,
transform: (Long) -> Pair<K, V>
): M
inline fun <K, V, M : MutableMap<in K, in V>> FloatArray.associateTo(
destination: M,
transform: (Float) -> Pair<K, V>
): M
inline fun <K, V, M : MutableMap<in K, in V>> DoubleArray.associateTo(
destination: M,
transform: (Double) -> Pair<K, V>
): M
inline fun <K, V, M : MutableMap<in K, in V>> BooleanArray.associateTo(
destination: M,
transform: (Boolean) -> Pair<K, V>
): M
inline fun <K, V, M : MutableMap<in K, in V>> CharArray.associateTo(
destination: M,
transform: (Char) -> Pair<K, V>
): M
في حال استدعاء الدالة associateByTo()
عبر مجموعة (Collection
) فستعيد القاموس المتغير destination
أزواجه توفرها الدالة keySelector()
مُطبقةً على عناصر المجموعة:
inline fun <T, K, V, M : MutableMap<in K, in V>> Iterable<T>.associateTo(
destination: M,
transform: (T) -> Pair<K, V>
): M
يُلاحَظ وجود الكلمة المفتاحية inline
للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).
القيم المعادة
قاموس. (انظر شرح الدالة أعلاه لمزيد من التفاصيل)
أمثلة
استخدام الدالة ()associateByToTo
مع اللوائح بتمرير دالة واحدة
تعرف الشيفرة الآتية لائحة باسم list
مكونة من أربعة أعداد باستخدام الدالة ()listOf
، ثم تنشئ قاموسًا متغيرًا باسم map
بتمرير الدالة ()func
(التي تضرب الأعداد في 4) إلى()associateByToTo
ثم تطبع الناتج:
fun main(args: Array<String>) {
val list = listOf(1,2,3,4)
val map = mutableMapOf<Int, Int>()
val func: (Int) -> Int = {it*4}
list.associateByTo(map,func)
println(map) // {4=1, 8=2, 12=3, 16=4}
}
استخدام الدالة ()associateByToTo
مع اللوائح بتمرير دالتين
تعرف الشيفرة الآتية لائحة باسم list
مكونة من ثلاثة أحرف باستخدام الدالة ()listOf
، ثم تنشئ قاموسًا متغيرًا باسم map
بتمرير الدالة ()
func
(التي تضرب الأعداد في 4) والدالة()func2
(التي تضيف 4 إلى العدد الممرر إليها) إلى()associateByToTo
ثم تطبع الناتج:
fun main(args: Array<String>) {
val list = listOf(1,2,3,4)
val map = mutableMapOf<Int, Int>()
val func: (Int) -> Int = {it*4}
val func2: (Int) -> Int = {it + 4}
list.associateByTo(map,func,func2)
println(map) // {4=5, 8=6, 12=7, 16=8}
}
انظر أيضًا
associateBy()
: تعيد قاموسًا (map).associate()
: تعيد قاموسًا (map).asList()
: تعيد لائحة والتي تُغلّف المصفوفة الاصلية.
asIterable()
: تُنشئ نسخة تكرارية (Iterable instance) والتي تُغلّف المصفوفة الاصلية وتعيد عناصرها عندما تُستخدم في حلقات التكرار (مثلfor
).