الفرق بين المراجعتين ل"Kotlin/collections/groupBy"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>groupBy()‎</code> في لغة Kotlin}}</noinclude> تُراكِم الدالة<code>groupBy()‎</code> القيم بدء...')
 
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>groupBy()‎</code> في لغة Kotlin}}</noinclude>
+
تعيد الدالة<code>groupBy()‎</code> [[Kotlin/collections/Map|قاموسًا]] يُجمّع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها حيث مفاتيحه تعيدها الدالة المُمرّرة <code>keySelector</code> وقيمه لوائحُ تضم عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] (أو ناتج تمرير عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] على الدالة <code>valueTransform</code> في حال تمريرها).
تُراكِم الدالة<code>groupBy()‎</code> القيم بدءًا من القيمة المُمرّرة <code>initial</code> وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر التالي من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وكذلك فهرسه. وتُعيد القيمة النهائية.  
+
 
 +
القاموس المُعاد يحافظ على على ترتيب التكرار (entry iteration order) للمفاتيح الناتجة عن [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] الأصلية.
 
==البنية العامة==
 
==البنية العامة==
يمكن استدعاء الدالة<code>foldIndexed()‎</code> على [[Kotlin/Array|المصفوفات]].<syntaxhighlight lang="kotlin">
+
<syntaxhighlight lang="kotlin">
inline fun <T, R> Array<out T>.foldIndexed(
+
inline fun <T, K> Array<out T>.groupBy(
     initial: R,
+
     keySelector: (T) -> K
    operation: (index: Int, acc: R, T) -> R
+
): Map<K, List<T>>
): R
+
inline fun <K> ByteArray.groupBy(
inline fun <R> ByteArray.foldIndexed(
+
     keySelector: (Byte) -> K
     initial: R,
+
): Map<K, List<Byte>>
    operation: (index: Int, acc: R, Byte) -> R
+
inline fun <K> ShortArray.groupBy(
): R
+
     keySelector: (Short) -> K
inline fun <R> ShortArray.foldIndexed(
+
): Map<K, List<Short>>
     initial: R,
+
inline fun <K> IntArray.groupBy(
    operation: (index: Int, acc: R, Short) -> R
+
     keySelector: (Int) -> K
): R
+
): Map<K, List<Int>>
inline fun <R> IntArray.foldIndexed(
+
inline fun <K> LongArray.groupBy(
     initial: R,
+
     keySelector: (Long) -> K
    operation: (index: Int, acc: R, Int) -> R
+
): Map<K, List<Long>>
): R
+
inline fun <K> FloatArray.groupBy(
inline fun <R> LongArray.foldIndexed(
+
     keySelector: (Float) -> K
     initial: R,
+
): Map<K, List<Float>>
    operation: (index: Int, acc: R, Long) -> R
+
inline fun <K> DoubleArray.groupBy(
): R
+
     keySelector: (Double) -> K
inline fun <R> FloatArray.foldIndexed(
+
): Map<K, List<Double>>
     initial: R,
+
inline fun <K> BooleanArray.groupBy(
    operation: (index: Int, acc: R, Float) -> R
+
     keySelector: (Boolean) -> K
): R
+
): Map<K, List<Boolean>>
inline fun <R> DoubleArray.foldIndexed(
+
inline fun <K> CharArray.groupBy(
     initial: R,
+
     keySelector: (Char) -> K
    operation: (index: Int, acc: R, Double) -> R
+
): Map<K, List<Char>>
): R
 
inline fun <R> BooleanArray.foldIndexed(
 
     initial: R,
 
    operation: (index: Int, acc: R, Boolean) -> R
 
): R
 
inline fun <R> CharArray.foldIndexed(
 
     initial: R,
 
    operation: (index: Int, acc: R, Char) -> R
 
): R
 
  
</syntaxhighlight>يمكن استدعاء غلدالة<code>foldIndexed()‎</code> على [[Kotlin/collections|المجموعات]].<syntaxhighlight lang="kotlin">
+
</syntaxhighlight>في حال استدعاء الدالة<code>groupBy()‎</code> على [[Kotlin/Array|المصفوفات]] مع تمرير معامل واحد <code>keySelector</code> فإنّها تُجمّع عناصر [[Kotlin/Array|المصفوفة]] الأصلية في [[Kotlin/collections/Map|قاموس]].حيث مفاتيحه تعيدها الدالة الممرّرة <code>keySelector()‎</code>  مُطبّقة على كل عناصر [[Kotlin/Array|المصفوفة]] وقيمه [[Kotlin/collections/List|لوائح]] تضم العناصر المقابلة.<syntaxhighlight lang="kotlin">
inline fun <T, R> Iterable<T>.foldIndexed(
+
inline fun <T, K, V> Array<out T>.groupBy(
     initial: R,  
+
     keySelector: (T) -> K,  
     operation: (index: Int, acc: R, T) -> R
+
     valueTransform: (T) -> V
): R
+
): Map<K, List<V>>
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+
inline fun <K, V> ByteArray.groupBy(
 +
    keySelector: (Byte) -> K,
 +
    valueTransform: (Byte) -> V
 +
): Map<K, List<V>>
 +
inline fun <K, V> ShortArray.groupBy(
 +
    keySelector: (Short) -> K,
 +
    valueTransform: (Short) -> V
 +
): Map<K, List<V>>
 +
inline fun <K, V> IntArray.groupBy(
 +
    keySelector: (Int) -> K,
 +
    valueTransform: (Int) -> V
 +
): Map<K, List<V>>
 +
inline fun <K, V> LongArray.groupBy(
 +
    keySelector: (Long) -> K,
 +
    valueTransform: (Long) -> V
 +
): Map<K, List<V>>
 +
inline fun <K, V> FloatArray.groupBy(
 +
    keySelector: (Float) -> K,
 +
    valueTransform: (Float) -> V
 +
): Map<K, List<V>>
 +
inline fun <K, V> DoubleArray.groupBy(
 +
    keySelector: (Double) -> K,
 +
    valueTransform: (Double) -> V
 +
): Map<K, List<V>>
 +
inline fun <K, V> BooleanArray.groupBy(
 +
    keySelector: (Boolean) -> K,
 +
    valueTransform: (Boolean) -> V
 +
): Map<K, List<V>>
 +
inline fun <K, V> CharArray.groupBy(
 +
    keySelector: (Char) -> K,
 +
    valueTransform: (Char) -> V
 +
): Map<K, List<V>>
 +
 
 +
</syntaxhighlight>في حال استدعاء الدالة<code>groupBy()‎</code> على [[Kotlin/Array|المصفوفات]] مع تمرير معاملين <code>valueTransform</code> و <code>keySelector</code> فإنّها تُجمّع العناصر المعادة من قبل الدالة  <code>valueTransform()‎</code> مُطبّقة على كل عناصر [[Kotlin/Array|المصفوفة]] وتربطها بالمفتاح الذي تعيده الدالة<code>keySelector()‎</code> مطبقة على على عناصر [[Kotlin/Array|المصفوفة]] وتعيد [[Kotlin/collections/Map|قاموسًا]] حيث كل مفتاح مرتبط [[Kotlin/collections/List|بلائحة]] العناصر المقابلة.<syntaxhighlight lang="kotlin">
 +
inline fun <T, K> Iterable<T>.groupBy(
 +
    keySelector: (T) -> K
 +
): Map<K, List<T>>
 +
</syntaxhighlight>في حال استدعاء الدالة<code>groupBy()‎</code> على [[Kotlin/collections|المجموعات]] مع تمرير معامل واحد <code>keySelector</code> فإنّها تُجمّع عناصر [[Kotlin/Array|المصفوفة]] الأصلية في [[Kotlin/collections/Map|قاموس]].حيث مفاتيحه تعيدها الدالة الممرّرة <code>keySelector()‎</code>  مُطبّقة على كل عناصر [[Kotlin/Array|المصفوفة]] وقيمه [[Kotlin/collections/List|لائحة]] تضم العناصر المقابلة.<syntaxhighlight lang="kotlin">
 +
inline fun <T, K, V> Iterable<T>.groupBy(
 +
    keySelector: (T) -> K,
 +
    valueTransform: (T) -> V
 +
): Map<K, List<V>>
 +
</syntaxhighlight>في حال استدعاء الدالة<code>groupBy()‎</code> على [[Kotlin/Array|المجموعات]] مع تمرير معاملين <code>valueTransform</code> و <code>keySelector</code> فإنّها تُجمّع العناصر المعادة من قبل الدالة  <code>valueTransform()‎</code> مُطبّقة على كل عناصر [[Kotlin/Array|المصفوفة]] وتربطها بالمفتاح الذي تعيده الدالة<code>keySelector()‎</code> مطبقة على على عناصر [[Kotlin/Array|المجموعة]] وتعيد [[Kotlin/collections/Map|قاموسًا]] حيث كل مفتاح مرتبط [[Kotlin/collections/List|بلائحة]] العناصر المقابلة.
 +
 
 +
يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
 
==القيم المٌعادة==
 
==القيم المٌعادة==
ناتج تطبيق العملية المُمرّرة <code>operation</code> تراكميًا على عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وكذلك فهارسها.  
+
[[Kotlin/collections/Map|قاموس]] يُجمّع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها حيث مفاتيحه تعيدها الدالة المُمرّرة <code>keySelector</code> وقيمه لوائحُ تضم عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] (أو ناتج تمرير عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] على الدالة <code>valueTransform</code> في حال تمريرها).
 
==أمثلة==
 
==أمثلة==
===استخدام الدالة <code>()groupBy</code> مع المصفوفات===
+
===استخدام الدالة <code>()groupBy</code> مع المصفوفات مع تمرير معامل واحد===
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()foldIndexed</code> على <code>array</code> بتمرير القيمة الأوّلية <code>0</code> إضافة إلى عملية تُضيف القيمة المتراكمة الراهنة إلى حاصل ضرب عناصر <code>array</code> في فهارسها، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ست سلاسل نصية باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()groupBy</code> على <code>array</code> بتمرير الدالة التي تعيد طول السلسلة النصية المُمرّرة، وتجمّع عناصر <code>array</code> التي لها نفس الطول في [[Kotlin/collections/Map|قاموس]]، ثم تطبع [[Kotlin/collections/Map|القاموس]]:<syntaxhighlight lang="kotlin">
 
fun main(args: Array<String>) {
 
fun main(args: Array<String>) {
val array = arrayOf(1,2,3,4,5,6)
+
    val array = arrayOf("a", "abc", "ab", "def","avde" ,"abcd")
  
val acc = array.foldIndexed(0) { acc , element , index -> acc + element*index }
+
    print(array.groupBy { it.length } ) // {1=[a], 3=[abc, def], 2=[ab], 4=[avde, abcd]}
print(acc) // 719
+
}
 +
</syntaxhighlight>
 +
===استخدام الدالة <code>()groupBy</code> مع المصفوفات مع تمرير مُعاملين===
 +
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ست سلاسل نصية باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()groupBy</code> على <code>array</code> بتمرير دالة تعيد طول السلسلة النصية المُمرّرة ودالة تعيد المصفوفة بالحروف الكبيرة، وتجمّع عناصر <code>array</code> التي لها نفس الطول في [[Kotlin/collections/Map|قاموس]] بتحويلها إلى الحروف الكبيرة، ثم تطبع [[Kotlin/collections/Map|القاموس]]:<syntaxhighlight lang="kotlin">
 +
fun main(args: Array<String>) {
 +
    val array = arrayOf("a", "abc", "ab", "def","avde" ,"abcd")
 +
 
 +
    print(array.groupBy( { it.length }, {it.toUpperCase()} )) // {1=[A], 3=[ABC, DEF], 2=[AB],
 +
                                                              // 4=[AVDE, ABCD]}
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
 
==انظر أيضًا==
 
==انظر أيضًا==
<code>[[Kotlin/collections/foldRight|foldRight()]]</code>‎:تُراكِم  القيم بدءًا من القيمة المُمرّرة <code>initial</code> وتطبّق العملية <code>operation</code> من اليمين إلى اليسار على القيمة المُتراكمة الراهنة وعلى العنصر التالي من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. وتُعيد القيمة النهائية. 
+
<code>[[Kotlin/collections/groupByTo|groupByTo()]]</code>‎: تضيف إلى [[Kotlin/collections/Map|القاموس]] المُمرّر  عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها حيث مفاتيحه تعيدها الدالة المُمرّرة <code>keySelector</code> وقيمه لوائحُ تضم عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] (أو ناتج تمرير عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] على الدالة <code>valueTransform</code> في حال تمريرها)
 
 
<code>[[Kotlin/collections/foldIndexed|foldIndexed()]]</code>‎:تُراكِم القيم بدءًا من القيمة المُمرّرة <code>initial</code> وتطبّق العملية <code>operation</code> من اليمين إلى اليسار  على القيمة المُتراكمة الراهنة وعلى العنصر التالي من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وكذلك فهرسه. وتُعيد القيمة النهائية
 
 
 
 
==مصادر==
 
==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/fold-indexed.html الدالة  groupBy()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/group-by.html الدالة  groupBy()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]<noinclude>{{DISPLAYTITLE: الدالة <code>groupBy()‎</code> في لغة Kotlin}}</noinclude>
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin Functions]]
 
[[تصنيف:Kotlin Functions]]

مراجعة 16:36، 19 مايو 2018

تعيد الدالةgroupBy()‎ قاموسًا يُجمّع عناصر المصفوفة أو المجموعة التي استُدعيت عبرها حيث مفاتيحه تعيدها الدالة المُمرّرة keySelector وقيمه لوائحُ تضم عناصر المصفوفة أو المجموعة (أو ناتج تمرير عناصر المصفوفة أو المجموعة على الدالة valueTransform في حال تمريرها).

القاموس المُعاد يحافظ على على ترتيب التكرار (entry iteration order) للمفاتيح الناتجة عن المصفوفة أو المجموعة الأصلية.

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

inline fun <T, K> Array<out T>.groupBy(
    keySelector: (T) -> K
): Map<K, List<T>>
inline fun <K> ByteArray.groupBy(
    keySelector: (Byte) -> K
): Map<K, List<Byte>> 
inline fun <K> ShortArray.groupBy(
    keySelector: (Short) -> K
): Map<K, List<Short>> 
inline fun <K> IntArray.groupBy(
    keySelector: (Int) -> K
): Map<K, List<Int>> 
inline fun <K> LongArray.groupBy(
    keySelector: (Long) -> K
): Map<K, List<Long>> 
inline fun <K> FloatArray.groupBy(
    keySelector: (Float) -> K
): Map<K, List<Float>> 
inline fun <K> DoubleArray.groupBy(
    keySelector: (Double) -> K
): Map<K, List<Double>> 
inline fun <K> BooleanArray.groupBy(
    keySelector: (Boolean) -> K
): Map<K, List<Boolean>> 
inline fun <K> CharArray.groupBy(
    keySelector: (Char) -> K
): Map<K, List<Char>>

في حال استدعاء الدالةgroupBy()‎ على المصفوفات مع تمرير معامل واحد keySelector فإنّها تُجمّع عناصر المصفوفة الأصلية في قاموس.حيث مفاتيحه تعيدها الدالة الممرّرة keySelector()‎ مُطبّقة على كل عناصر المصفوفة وقيمه لوائح تضم العناصر المقابلة.

inline fun <T, K, V> Array<out T>.groupBy(
    keySelector: (T) -> K, 
    valueTransform: (T) -> V
): Map<K, List<V>> 
inline fun <K, V> ByteArray.groupBy(
    keySelector: (Byte) -> K, 
    valueTransform: (Byte) -> V
): Map<K, List<V>> 
inline fun <K, V> ShortArray.groupBy(
    keySelector: (Short) -> K, 
    valueTransform: (Short) -> V
): Map<K, List<V>> 
inline fun <K, V> IntArray.groupBy(
    keySelector: (Int) -> K, 
    valueTransform: (Int) -> V
): Map<K, List<V>> 
inline fun <K, V> LongArray.groupBy(
    keySelector: (Long) -> K, 
    valueTransform: (Long) -> V
): Map<K, List<V>> 
inline fun <K, V> FloatArray.groupBy(
    keySelector: (Float) -> K, 
    valueTransform: (Float) -> V
): Map<K, List<V>> 
inline fun <K, V> DoubleArray.groupBy(
    keySelector: (Double) -> K, 
    valueTransform: (Double) -> V
): Map<K, List<V>> 
inline fun <K, V> BooleanArray.groupBy(
    keySelector: (Boolean) -> K, 
    valueTransform: (Boolean) -> V
): Map<K, List<V>> 
inline fun <K, V> CharArray.groupBy(
    keySelector: (Char) -> K, 
    valueTransform: (Char) -> V
): Map<K, List<V>>

في حال استدعاء الدالةgroupBy()‎ على المصفوفات مع تمرير معاملين valueTransform و keySelector فإنّها تُجمّع العناصر المعادة من قبل الدالة valueTransform()‎ مُطبّقة على كل عناصر المصفوفة وتربطها بالمفتاح الذي تعيده الدالةkeySelector()‎ مطبقة على على عناصر المصفوفة وتعيد قاموسًا حيث كل مفتاح مرتبط بلائحة العناصر المقابلة.

inline fun <T, K> Iterable<T>.groupBy(
    keySelector: (T) -> K
): Map<K, List<T>>

في حال استدعاء الدالةgroupBy()‎ على المجموعات مع تمرير معامل واحد keySelector فإنّها تُجمّع عناصر المصفوفة الأصلية في قاموس.حيث مفاتيحه تعيدها الدالة الممرّرة keySelector()‎ مُطبّقة على كل عناصر المصفوفة وقيمه لائحة تضم العناصر المقابلة.

inline fun <T, K, V> Iterable<T>.groupBy(
    keySelector: (T) -> K, 
    valueTransform: (T) -> V
): Map<K, List<V>>

في حال استدعاء الدالةgroupBy()‎ على المجموعات مع تمرير معاملين valueTransform و keySelector فإنّها تُجمّع العناصر المعادة من قبل الدالة valueTransform()‎ مُطبّقة على كل عناصر المصفوفة وتربطها بالمفتاح الذي تعيده الدالةkeySelector()‎ مطبقة على على عناصر المجموعة وتعيد قاموسًا حيث كل مفتاح مرتبط بلائحة العناصر المقابلة.

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

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

قاموس يُجمّع عناصر المصفوفة أو المجموعة التي استُدعيت عبرها حيث مفاتيحه تعيدها الدالة المُمرّرة keySelector وقيمه لوائحُ تضم عناصر المصفوفة أو المجموعة (أو ناتج تمرير عناصر المصفوفة أو المجموعة على الدالة valueTransform في حال تمريرها).

أمثلة

استخدام الدالة ()groupBy مع المصفوفات مع تمرير معامل واحد

تعرف الشيفرة الآتية مصفوفة باسم array مكونة من ست سلاسل نصية باستخدام الدالة ()arrayOf، ثم تستخدم الدالة ()groupBy على array بتمرير الدالة التي تعيد طول السلسلة النصية المُمرّرة، وتجمّع عناصر array التي لها نفس الطول في قاموس، ثم تطبع القاموس:

fun main(args: Array<String>) {
    val array = arrayOf("a", "abc", "ab", "def","avde" ,"abcd")

    print(array.groupBy { it.length } ) // {1=[a], 3=[abc, def], 2=[ab], 4=[avde, abcd]}
}

استخدام الدالة ()groupBy مع المصفوفات مع تمرير مُعاملين

تعرف الشيفرة الآتية مصفوفة باسم array مكونة من ست سلاسل نصية باستخدام الدالة ()arrayOf، ثم تستخدم الدالة ()groupBy على array بتمرير دالة تعيد طول السلسلة النصية المُمرّرة ودالة تعيد المصفوفة بالحروف الكبيرة، وتجمّع عناصر array التي لها نفس الطول في قاموس بتحويلها إلى الحروف الكبيرة، ثم تطبع القاموس:

fun main(args: Array<String>) {
    val array = arrayOf("a", "abc", "ab", "def","avde" ,"abcd")

    print(array.groupBy( { it.length }, {it.toUpperCase()} )) // {1=[A], 3=[ABC, DEF], 2=[AB], 
                                                              // 4=[AVDE, ABCD]}
}

انظر أيضًا

groupByTo()‎: تضيف إلى القاموس المُمرّر عناصر المصفوفة أو المجموعة التي استُدعيت عبرها حيث مفاتيحه تعيدها الدالة المُمرّرة keySelector وقيمه لوائحُ تضم عناصر المصفوفة أو المجموعة (أو ناتج تمرير عناصر المصفوفة أو المجموعة على الدالة valueTransform في حال تمريرها). 

مصادر