الفرق بين المراجعتين لصفحة: «Kotlin/collections/associate»

المراجعة الحالية بتاريخ 07:04، 8 سبتمبر 2018

تعيد الدالة associate()‎ خريطةً (map) تحوي أزواجًا من "مفتاح/قيمة" ناتجة عن تمرير عناصر المصفوفة أو المجموعة (Collection) إلى الدالة المررة إليها.

إن كان لزوجين نفس المفتاح (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)).

المعاملات

`transform`

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

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

خريطةً تحوي أزواجًا من "مفتاح/قيمة" ناتجة عن تمرير عناصر مصفوفةٍ أو مجموعةٍ إلى الدالة ()transform.

أمثلة

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

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) تحتوي على عناصر المصفوفة أو المجموعة المعطاة مُفهرسة بناتج تمرير هذه العناصر إلى الدالة keySelector.
الدالة asList()‎: تعيد لائحة والتي تُغلّف المصفوفة الأصليَّة.

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

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>associateBy()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>associate()‎</code> في لغة Kotlin}}</noinclude>
-تعيد الدالة <code>associateBy()‎</code> قاموسًا (map) يحتوي ناتج تمرير عناصر المصفوفة أو المجموعة (<code>[[Kotlin/collections|Collection]]</code>) إلى الدالة <code>valueTransform</code> مُفهرسة بناتج تمرير عناصر المصفوفة أو المجموعة إلى الدالة <code>keySelector</code>.
+تعيد الدالة <code>associate()‎</code> [[Kotlin/collections/Map|خريطةً]] (map) تحوي أزواجًا من "مفتاح/قيمة" ناتجة عن تمرير عناصر المصفوفة أو المجموعة ([[Kotlin/collections|Collection]]) إلى الدالة المررة إليها.
-ان كان لعنصرين نفس المفتاح (key) بعد تطبيق الدالة<code>keySelector</code> فإن الأخير هو الذي سيُضاف إلى القاموس.
+إن كان لزوجين نفس المفتاح (key)  فالأخير هو الذي سيُضاف إلى الخريطة.
-القاموس المُعاد يحافظ على نفس ترتيب التكرار الخاص بالمصفوفة أو المجموعة الأصلية.
+تحافظ الخريطة المُعادة على نفس ترتيب التكرار الخاص بالمصفوفة أو المجموعة الأصليَّة.
 ==البنية العامة==
-في حال استدعاء الدالة <code>associateBy()‎</code>عبر مصفوفة فستعيد قاموسًا (map) يحتوي عناصر المصفوفة مُفهرسة بناتج تمرير عناصر المصفوفة إلى الدالة <code>keySelector:</code><syntaxhighlight lang="kotlin">
+تعيد الدالة <code>associate()‎</code> خريطةً (map) تحوي أزواجًا من "مفتاح/قيمة" ناتجة عن تمرير عناصر مصفوفةٍ إلى الدالة <code>()transform</code>.<syntaxhighlight lang="kotlin">
-inline fun <T, K> Array<out T>.associateBy(keySelector: (T) -> K): Map<K, T>
+inline fun <T, K, V> Array<out T>.associate(
-inline fun <K> ByteArray.associateBy(keySelector: (Byte) -> K): Map<K, Byte>
+     transform: (T) -> Pair<K, V>
-inline fun <K> ShortArray.associateBy(keySelector: (Short) -> K): Map<K, Short>
+): Map<K, V>
-inline fun <K> IntArray.associateBy(keySelector: (Int) -> K): Map<K, Int>
+inline fun <K, V> ByteArray.associate(
-inline fun <K> LongArray.associateBy(keySelector: (Long) -> K): Map<K, Long>
+     transform: (Byte) -> Pair<K, V>
-inline fun <K> FloatArray.associateBy(keySelector: (Float) -> K): Map<K, Float>
-inline fun <K> DoubleArray.associateBy(keySelector: (Double) -> K): Map<K, Double>
-inline fun <K> BooleanArray.associateBy(keySelector: (Boolean) -> K): Map<K, Boolean>
-inline fun <K> CharArray.associateBy(keySelector: (Char) -> K): Map<K, Char>
-</syntaxhighlight>في حال استدعاء الدالة <code>associateBy()‎</code>عبر  مصفوفة فستعيد قاموسًا (map) يحتوي ناتج تمرير عناصر المصفوفة إلى الدالة <code>valueTransform</code> مُفهرسة بناتج تمرير عناصر المصفوفة إلى الدالة <code>keySelector:</code><syntaxhighlight lang="kotlin">
-inline fun <T, K, V> Array<out T>.associateBy(
-     keySelector: (T) -> K,
-    valueTransform: (T) -> V
-): Map<K, V>
-inline fun <K, V> ByteArray.associateBy(
-     keySelector: (Byte) -> K,
-    valueTransform: (Byte) -> V
 ): Map<K, V>
-inline fun <K, V> ShortArray.associateBy(
+inline fun <K, V> ShortArray.associate(
-     keySelector: (Short) -> K,
+     transform: (Short) -> Pair<K, V>
-    valueTransform: (Short) -> V
 ): Map<K, V>
-inline fun <K, V> IntArray.associateBy(
+inline fun <K, V> IntArray.associate(
-     keySelector: (Int) -> K,
+     transform: (Int) -> Pair<K, V>
-    valueTransform: (Int) -> V
 ): Map<K, V>
-inline fun <K, V> LongArray.associateBy(
+inline fun <K, V> LongArray.associate(
-     keySelector: (Long) -> K,
+     transform: (Long) -> Pair<K, V>
-    valueTransform: (Long) -> V
 ): Map<K, V>
-inline fun <K, V> FloatArray.associateBy(
+inline fun <K, V> FloatArray.associate(
-     keySelector: (Float) -> K,
+     transform: (Float) -> Pair<K, V>
-    valueTransform: (Float) -> V
 ): Map<K, V>
-inline fun <K, V> DoubleArray.associateBy(
+inline fun <K, V> DoubleArray.associate(
-     keySelector: (Double) -> K,
+     transform: (Double) -> Pair<K, V>
-    valueTransform: (Double) -> V
 ): Map<K, V>
-inline fun <K, V> BooleanArray.associateBy(
+inline fun <K, V> BooleanArray.associate(
-     keySelector: (Boolean) -> K,
+     transform: (Boolean) -> Pair<K, V>
-    valueTransform: (Boolean) -> V
 ): Map<K, V>
-inline fun <K, V> CharArray.associateBy(
+inline fun <K, V> CharArray.associate(
-     keySelector: (Char) -> K,
+     transform: (Char) -> Pair<K, V>
-    valueTransform: (Char) -> V
 ): Map<K, V>
-</syntaxhighlight>في حال استدعاء الدالة <code>associateBy()‎</code>عبر مجموعة (<code>[[Kotlin/collections|Collection]]</code>) فستعيد قاموسًا (map) يحتوي عناصر المجموعة مُفهرسة بناتج تمرير عناصر المجموعة إلى الدالة <code>keySelector:</code><syntaxhighlight lang="kotlin">
+</syntaxhighlight>تعيد الدالة <code>associate()‎</code> خريطةً (map) تحوي أزواجًا من "مفتاح/قيمة" ناتجة عن تمرير عناصر مجموعةٍ ([[Kotlin/collections|Collection]]) إلى الدالة <code>transform</code>.<syntaxhighlight lang="kotlin">
-inline fun <T, K> Iterable<T>.associateBy(keySelector: (T) -> K): Map<K, T>
+inline fun <T, K, V> Iterable<T>.associate(
-</syntaxhighlight>في حال استدعاء الدالة <code>associateBy()‎</code>عبر  مجموعة (<code>[[Kotlin/collections|Collection]]</code>) فستعيد قاموسًا (map) يحتوي ناتج تمرير عناصر  المجموعة (<code>[[Kotlin/collections|Collection]]</code>) إلى الدالة <code>valueTransform</code> مُفهرسة بناتج تمرير عناصر  المجموعة إلى الدالة <code>keySelector:</code><syntaxhighlight lang="kotlin">
+    transform: (T) -> Pair<K, V>
-inline fun <T, K, V> Iterable<T>.associateBy(
+): Map<K, V>
-    keySelector: (T) -> K,
+</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]).
-    valueTransform: (T) -> V
-): Map<K, V>
+== المعاملات ==
-</syntaxhighlight>
+=== <code>transform</code> ===
+دالةٌ يمرر إليها كل عنصر من عناصر المصفوفة أو المجموعة المعطاة وتعيد خريطة تحتوي أزواجًا من "مفتاح/قيمة".
 ==القيم المعادة==
-قاموس. (انظر شرح الدالة أعلاه لمزيد من التفاصيل)
+خريطةً تحوي أزواجًا من "مفتاح/قيمة" ناتجة عن تمرير عناصر مصفوفةٍ أو مجموعةٍ إلى الدالة <code>()transform</code>.
 ==أمثلة==
-===استخدام الدالة <code>()associateBy</code> مع اللوائح بتمرير دالة واحدة===
+تعرِّف الشيفرة الآتية قائمة باسم <code>list</code> مكونة من ثلاثة حروف باستخدام الدالة <code>()listOf</code>، ثمَّ تنشئ خريطةً باسم <code>map</code> بتمرير الدالة <code>()toMap</code> إلى <code>()associate</code>التي تحول تلك الحروف إلى زوج مكون من الحرف في الحالة الكبيرة (UpperCase) ومن القيمة العددية المقابلة له:<syntaxhighlight lang="kotlin">
-تعرف الشيفرة الآتية لائحة باسم <code>list</code> مكونة من ثلاثة أحرف باستخدام الدالة <code>()listOf</code>، ثم تنشئ قاموسًا باسم <code>map</code> بتمرير الدالة <code>()upper</code> (التي تحول الحروف إلى الحالة UpperCase) إلى<code>()associateBy</code>  ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-     val list = listOf('a','b','c')
+     val list = listOf('a', 'b', 'c')
-     val upper: (Char) -> Char = {it.toUpperCase()}
+     val toMap: (Char) -> Pair<Char, Int> = {
-    val map = list.associateBy(upper)
+        Pair(it.toUpperCase(), it.toInt())
-    println(map) // {A=a, B=b, C=c}
+    }
-}
+     val map = list.associate(toMap)
-</syntaxhighlight>
-===استخدام الدالة <code>()associateBy</code> مع اللوائح بتمرير دالتين===
-تعرف الشيفرة الآتية لائحة باسم <code>list</code> مكونة من ثلاثة أحرف باستخدام الدالة <code>()listOf</code>، ثم تنشئ قاموسًا باسم <code>map</code> بتمرير الدالة <code>()upper</code> (التي تحول الحروف إلى الحالة UpperCase) والدالة<code>()multr</code> (التي تحول الحروف إلى عدد) إلى<code>()associateBy</code>  ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
-fun main(args: Array<String>) {
-    val list = listOf('a','b','c')
-    val upper: (Char) -> Char = {it.toUpperCase()}
-    val mult: (Char) -> Int = {it.toInt()}
-     val map = list.associateBy(upper, mult)
      println(map) // {A=97, B=98, C=99}
 }
 </syntaxhighlight>
 ==انظر أيضًا==
-*<code>[[Kotlin/collections/associateBy|associateBy()]]</code>‎: تعيد قاموسًا (map).
+*الدالة <code>[[Kotlin/collections/associateBy|associateBy()]]</code>‎: تعيد خريطةً (map) تحتوي على عناصر المصفوفة أو المجموعة المعطاة مُفهرسة بناتج تمرير هذه العناصر إلى الدالة <code>keySelector</code>.
-*<code>[[Kotlin/collections/asList|asList()]]</code>‎: تعيد لائحة والتي تُغلّف المصفوفة الاصلية.
+*الدالة <code>[[Kotlin/collections/asList|asList()]]</code>‎: تعيد لائحة والتي تُغلّف المصفوفة الأصليَّة.
-* <code>[[Kotlin/collections/asIterable|asIterable()]]</code>‎: تُنشئ نسخة تكرارية (Iterable instance) والتي تُغلّف المصفوفة الاصلية وتعيد عناصرها عندما تُستخدم في حلقات التكرار (مثل<code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code>).
+* الدالة <code>[[Kotlin/collections/asIterable|asIterable()]]</code>‎: تُنشئ نسخة تكراريَّة (Iterable instance) تُغلّف المصفوفة الأصلية وتعيد عناصرها عندما تُستخدم في حلقات التكرار (مثل <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code>).
 ==مصادر==
-*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/associate-by.html الدالة  associate()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/associate.html صفحة الدالة associate()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Collection]]